New-OfficeWebAppsFarm
ローカル コンピューターで新しい Office Online Server ファームを作成します。
構文
New-OfficeWebAppsFarm
[-Force]
[-FarmOU <String>]
[-InternalURL <String>]
[-ExternalURL <String>]
[-AllowHttp]
[-AllowOutboundHttp]
[-SSLOffloaded]
[-CertificateName <String>]
[-S2SCertificateName <String>]
[-EditingEnabled]
[-Proxy <String>]
[-LogLocation <String>]
[-LogRetentionInDays <UInt32>]
[-LogVerbosity <String>]
[-CacheLocation <String>]
[-MaxMemoryCacheSizeInMB <Int32>]
[-DocumentInfoCacheSize <UInt32>]
[-CacheSizeInGB <Int32>]
[-ClipartEnabled]
[-TranslationEnabled]
[-MaxTranslationCharacterCount <Int32>]
[-TranslationServiceAppId <String>]
[-TranslationServiceAddress <String>]
[-RenderingLocalCacheLocation <String>]
[-RecycleActiveProcessCount <UInt32>]
[-AllowCEIP]
[-ExcelRequestDurationMax <Int32>]
[-ExcelSessionTimeout <Int32>]
[-ExcelWorkbookSizeMax <Int32>]
[-ExcelPrivateBytesMax <Int32>]
[-ExcelConnectionLifetime <Int32>]
[-ExcelExternalDataCacheLifetime <Int32>]
[-ExcelAllowExternalData]
[-ExcelUseEffectiveUserName]
[-ExcelWarnOnDataRefresh]
[-ExcelUdfsAllowed]
[-ExcelMemoryCacheThreshold <Int32>]
[-ExcelUnusedObjectAgeMax <Int32>]
[-ExcelCachingUnusedFiles]
[-ExcelAbortOnRefreshOnOpenFail]
[-ExcelAutomaticVolatileFunctionCacheLifeTime <Int32>]
[-ExcelConcurrentDataRequestsPerSessionMax <Int32>]
[-ExcelDefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
[-ExcelRestExternalDataEnabled]
[-ExcelChartAndImageSizeMax <Int32>]
[-OpenFromUrlEnabled]
[-OpenFromUncEnabled]
[-OpenFromUrlThrottlingEnabled]
[-PicturePasteDisabled]
[-RemovePersonalInformationFromLogs]
[-AllowHttpSecureStoreConnections]
[-WhatIf]
[-Confirm]
説明
New-OfficeWebAppsFarm コマンドレットは、ローカル コンピューターに新しいOffice Online Server ファームを作成します。 このコマンドレットは、Office Online Server ファーム内の最初のサーバーで実行し、New-OfficeWebAppsMachine コマンドレットを使用してファームにさらにサーバーを追加します。
例
------------------ 例 1 ---------------------
New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true
次の使用例は、ブラウザーで Office の編集が有効になっているローカル サーバーにOffice Online Server ファームを作成します。 この例では、内部ユーザーと外部ユーザーの両方に対して 1 つの URL のみが使用されます。 [証明書名] の値は、コンピューターの証明書ストアに表示される証明書のフレンドリ名です。
パラメーター
-AllowCEIP
Office Online Server ファーム内のすべてのサーバーでカスタマー エクスペリエンス向上プログラム (CEIP) レポートを有効にします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowHttp
HTTP アクセス用に IIS サイトをポート 80 にプロビジョニングする必要があることを示します。 AllowHTTP は、すべてのコンピューターが IPSEC (完全な暗号化) を必要とする環境、または機密保持を要するファイルを含まないテスト環境でのみ使用してください。
SSLOffloaded を有効にすると、自動的に有効にされます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowHttpSecureStoreConnections
非 SSL 接続 (HTTP など) を使用して Secure Store 接続を確立できることを示します。 既定は False です。
>AllowHTTPSecureStoreConnections は、すべてのコンピューターが IPSEC (完全な暗号化) を必要とする環境、または機密ファイルが含まれないテスト環境でのみ使用してください。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowOutboundHttp
Office Online Serverからの送信 HTTP 接続を許可します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CacheLocation
表示された画像ファイルを保存するグローバル ディスク キャッシュの場所を指定します。 既定の場所は %programdata%\Microsoft\OfficeWebApps\Working\d です。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CacheSizeInGB
グローバル ディスク キャッシュの最大サイズをギガバイト単位で指定します。
型は、0 または正の整数の、整数値である必要があります。 既定サイズは 15 GB です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateName
HTTPS バインドの作成に使用Office Online Server証明書のフレンドリ名を指定します。
指定した証明書が見つからないか期限切れの場合、または、指定した値が複数の証明書に関連付けられている場合は、エラーがログに記録され、ファームは作成されません。
この値は、Office Online Server ファームに参加するすべてのサーバーで使用されます。 つまり、ファーム内のすべてのサーバーがこのフレンドリ名の証明書を持つ必要があります。
AllowHttp または SSLOffloaded パラメーターを使用している場合は、CertificateName パラメーターを指定する必要はありません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClipartEnabled
Office ドキュメントにBingイメージを挿入するためのサポートを有効にします。 この機能には、サーバー間通信が必要です。直接構成するか、Proxy パラメーターを使用して指定したプロキシを使用して構成します。
Bing 画像が機能するためには、OpenFromUrlEnabled パラメーターを True に設定する必要があります。 既定は False です。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドを実行する前に確認メッセージを表示します。 詳細を表示するには、「get-help about_commonparameters」と入力します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DocumentInfoCacheSize
メモリ キャッシュに保存されるドキュメント変換レコードの最大数を指定します。
既定値は 5000 レコードです。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EditingEnabled
ブラウザーでの編集のサポートを有効にします。 既定は False です。 編集機能を使用できる適切なライセンス契約を持っている場合にのみ、True に設定します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelAbortOnRefreshOnOpenFail
データの更新が失敗した場合に、ブックが読み込まれないようにします。 これにより、ユーザーに対して古い情報またはアクセス権がない情報が表示されないようにできます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelAllowExternalData
ブックに外部データへの接続が含まれているブラウザーで、Excel ブックでサポートされている外部データの更新を有効にします。 既定値は True です。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelAutomaticVolatileFunctionCacheLifeTime
揮発性関数の計算値が自動計算のためにキャッシュされる最大時間 (秒単位) を指定します。 -1:ブックの読み込み時に計算を 1 回実行します。 0: 常に計算を実行します。 1 から 2,073,600: 1 秒から 24 日の間、キャッシュします。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelCachingUnusedFiles
Web Excel セッションで使用されなくなったファイルのキャッシュを有効にします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelChartAndImageSizeMax
ブラウザーで Excel で開くことができるグラフまたは画像の最大サイズをメガバイト単位で指定します。 値は 0 より大きい整数である必要があります。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelConcurrentDataRequestsPerSessionMax
1 つのセッションで同時に許容される外部データ要求の最大数を指定します。 1 つのセッションでこれよりも多くの要求を発行する必要がある場合は、超過分の要求はキューに格納されます。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelConnectionLifetime
ブラウザーでの Excel の外部データ接続の期間を秒単位で指定します。 既定値は 1800 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelDefaultWorkbookCalcMode
PARAMVALUE:ファイル | 手動 |自動 |AutoDataTables
Type: | DefaultWorkbookCalcMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelExternalDataCacheLifetime
ブラウザーでの Excel の外部データ キャッシュの有効期間の期間を秒単位で指定します。 既定値は 300 秒です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelMemoryCacheThreshold
非アクティブなオブジェクトに割り当てることができる最大プライベート バイト数の割合。 メモリ キャッシュのしきい値を超えると、キャッシュに残っている現在使用されていないオブジェクトは解放されます。 有効な値: 0 (非アクティブなオブジェクトのキャッシュを無効にします)。1 から 95 まで。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelPrivateBytesMax
ブラウザーで Excel によって使用される最大プライベート バイトをメガバイト単位で指定します。 -1 を設定した場合、プライベート バイトの最大サイズは、既定でコンピューター上の物理メモリの 50% に設定されます。
この型は、-1 または任意の正の整数であることが必要です。 既定値は -1 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelRequestDurationMax
セッションの 1 つの要求の最大持続時間を秒単位で指定します。 この時間が経過すると、要求はタイムアウトします。
この型は、-1 (無期限)、または 1 ~ 2,073,600 の範囲の整数であることが必要です。 既定値は 300 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelRestExternalDataEnabled
REST API からの要求を許可して、外部データ接続を更新します。 [外部データの許可] が None に設定されている場合、この設定は無効になります。 Bool のチェック ボックスをオンにします。 既定値は False です。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelSessionTimeout
ユーザー アクティビティがない場合に、ブラウザーでセッションがアクティブな状態を維持する時間を秒単位で指定します。 有効な値は次のとおりです。
-1 セッションが期限切れになることはありません。
0 セッションは、1 つの要求の最後に期限切れになります。
1 ~ 2,073,600 1 秒~ 24 日の間、アクティブです。 既定値は 450 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelUdfsAllowed
ブラウザーで Excel のユーザー定義関数を有効にします。 既定は False です。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelUnusedObjectAgeMax
非アクティブなオブジェクトがメモリ キャッシュに残る最大時間 (分)。 非アクティブなオブジェクトは、セッションで使用されないオブジェクトです。 有効な値: -1 (最大値なし)。1 から 34560 (24 日)。 既定値は -1 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelUseEffectiveUserName
ブラウザーで Excel で Analysis Services EffectiveUserName パラメーターを使用できるようにします。 既定は False です。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelWarnOnDataRefresh
ブラウザーで Excel でデータが更新されたときに表示される警告ダイアログをオフまたはオンにします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcelWorkbookSizeMax
読み込み可能なブックの最大サイズ (MB 単位) を指定します。
この型は、1 ~ 2,000 の範囲の整数値であることが必要です。 既定値は 10 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalURL
クライアントがインターネットからOffice Online Server ファームにアクセスするために使用する URL ルートを指定します。 負荷分散されたマルチサーバー Office Online Server ファームの場合、外部 URL は外部向けロード バランサーの IP アドレスにバインドされます。
Office Online Server ファームには、ExternalURL または InternalURL を使用して設定された少なくとも 1 つの URL が必要です。 内部および外部 URL の両方を設定することもできます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FarmOU
Office Online Server ファームに参加するには、サーバーが のメンバーである必要がある Active Directory 組織単位 (OU) の名前を指定します。 このパラメーターを使用して、承認されていないサーバー (つまり、OU に存在しないサーバー) がOffice Online Server ファームに参加しないようにします。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
ユーザー プロンプトを表示せずに、すべての確認に対して [はい] と回答します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InternalURL
クライアントがイントラネットからOffice Online Server ファームにアクセスするために使用する URL ルートを指定します。
Office Online Server ファームには、ExternalURL または InternalURL を使用して設定された少なくとも 1 つの URL が必要です。 内部および外部 URL の両方を設定することもできます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LogLocation
アクティビティ ログが保存される、ローカル コンピューターでの場所を指定します。
この場所は、ファーム内のすべてのサーバーに適用され、サーバーごとにカスタマイズはできません。 既定の場所は %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS です。
ログが保存されるドライブに、十分な空きディスク領域があることを確認してください。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LogRetentionInDays
ログ エントリを保持する日数を指定します。 構成された日付より古いログ エントリはトリムされます。
この型は、0 ~ 365 の範囲の整数である必要があります。 既定値は 7 日です。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LogVerbosity
トレース ログ ファイルに保存される情報の量を指定します。 値は、次のとおりです。
VerboseEX は、トレース ログ ファイルに (最も情報量が多い) 低レベルの詳細を書き込みます。 大規模になるトレースで役立ちます。
Verbose は、トレース ログ ファイルに低レベルの詳細を書き込みます。
Medium は、トレース ログ ファイルに中レベルの詳細を書き込みます。
High は、トレース ログ ファイルに (情報量が少ない) 高レベルの詳細を書き込みます。
Monitorable は、監視する必要がある特殊なコード パスおよびアクションを示すトレースを作成します。
Unexpected は、監視する必要がある予測外のコード パスおよびアクションを示すトレースを作成します。
None は、トレース ログ ファイルにトレース情報を書き込みません。
LogVerbosity を長時間、低レベルのままにするとパフォーマンスを低下させます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxMemoryCacheSizeInMB
レンダリング キャッシュが使用できるメモリの最大量をメガバイト単位で指定します。
型は、0 または正の整数の、整数値である必要があります。 既定サイズは 75 MB です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxTranslationCharacterCount
ドキュメントが翻訳できるようにする目的で、含める文字の最大数を指定します。
型は整数値である必要があります。 設定できる値は、2000 から 2,000,000 で、制限をしない場合は 0 を指定できます。 既定値は 125,000 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OpenFromUncEnabled
オンライン ビューアーを使用して UNC パスから Office ファイルを表示するかのオンとオフを切り替えます。
最初に OpenFromUrlEnabled を True に設定し、オンライン ビューアーで UNC パスのファイルを表示できるようにします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OpenFromUrlEnabled
オンライン ビューアーを使用して URL または UNC パスから Office ファイルを表示する機能をオンまたはオフにします。 既定は False です。
ClipartEnabled を使用する場合は、このパラメーターを True に設定する必要があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OpenFromUrlThrottlingEnabled
特定のサーバーからの Open From URL 要求の数を一定期間で調整します。 構成できない既定の調整値は、Office Online Server ファームが、オンライン ビューアーでコンテンツを表示するための要求で単一のサーバーを圧倒しないようにします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PicturePasteDisabled
ユーザーが Web ページからブラウザーの Office に画像を貼り付ける機能をオフにします。 既定は False です。 OpenFromURLEnabled が True に設定され、PicturePasteDisabled が False に設定されていない場合、ユーザーはブラウザーで Office にイメージを貼り付けることができます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
外部サイトへの HTTP 要求を可能にする目的で構成されたプロキシ サーバーの URL を指定します。 一般的には、ClipartEnabled および TranslationEnabled パラメーターとともに構成されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecycleActiveProcessCount
プロセスをリサイクルする前に、1 つの Word または PowerPoint プロセスでレンダリングできるファイルの数を指定します。
この型は、1 ~ 1000 の範囲の整数である必要があります。 既定値は 5 です。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemovePersonalInformationFromLogs
Office Online Serverログからの個人情報のベスト エフォート スクラブを提供し、値を SHA256 ハッシュに置き換えます。 Potentially scrubbed information can be:
ドキュメント名および URL
IP アドレス
電子メール アドレス
ユーザー名
既定は False です。 このパラメーターを有効にしても、個人情報がOffice Online Server ログに記録されることは保証されません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RenderingLocalCacheLocation
Word および PowerPoint 表示サービスで使用する一時キャッシュの場所を指定します。
既定の場所は %programdata%\Microsoft\OfficeWebApps\Working\waccache です。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-S2SCertificateName
SharePoint Server でのサーバー間認証に使用する証明書のフレンドリ名。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSLOffloaded
SSL がロード バランサーにオフロードされることをOffice Online Server ファーム内のサーバーに示します。 SSLOffloaded が有効にされると、Web アプリケーションは、ローカル サーバーのポート 80 (HTTP) にバインドされます。 しかし、CSS または画像のようなその他のリソースを参照する HTML は、参照に HTTPS URL を使用します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TranslationEnabled
各言語間でテキストを翻訳するオンライン サービスである Microsoft Translator を使用する、自動的なドキュメント翻訳のサポートを有効にします。 翻訳されたファイルが Word に表示されます。 Microsoft Translator はオンライン サービスであることから、直接の、または Proxy パラメーターで指定するプロキシを使用する、サーバーから Web への通信を有効にする必要があります。
Microsoft Translator は、翻訳の品質を向上する目的でデータを収集することがあります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TranslationServiceAddress
翻訳要求の送信先となる翻訳サーバーの URL を指定します。 既定値は、Microsoft Translator オンライン サービスです。 通常、翻訳サービスを変更する必要がない限り、このパラメーターは使用しません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TranslationServiceAppId
翻訳サービスのアプリケーション ID を指定します。 既定値は、ブラウザーの Office のパブリック アプリケーション ID です。 通常、追加のサービスについて Microsoft Translator とネゴシエートし、プライベート アプリケーション ID を提供していない限り、このパラメーターは使用しません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細を表示するには、「get-help about_commonparameters」と入力します。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |