New-OfficeWebAppsFarm

モジュール:

OfficeOnlineServerPowerShell

ローカル コンピューターで新しい 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