Set-OfficeWebAppsFarm

構文

Default (既定)

Set-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]

説明

例

例 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

例 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

例 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

パラメーター

-AllowCEIP

Office Online Server ファーム内のすべてのサーバーでカスタマー エクスペリエンス向上プログラム (CEIP) レポートを有効にします。

この変更を有効にするには、Office Online Server ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-AllowHttp

HTTP アクセス用に IIS サイトをポート 80 にプロビジョニングする必要があることを示します。 AllowHTTP は、すべてのコンピューターが IPSEC (完全な暗号化) を必要とする環境、または機密保持を要するファイルを含まないテスト環境でのみ使用してください。

SSLOffloaded を有効にすると、自動的に有効にされます。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-AllowHttpSecureStoreConnections

非 SSL 接続 (HTTP など) を使用して Secure Store 接続を確立できることを示します。 既定は False です。

>AllowHTTPSecureStoreConnections は、すべてのコンピューターが IPSEC (完全な暗号化) を必要とする環境、または機密ファイルが含まれないテスト環境でのみ使用してください。

パラメーターのプロパティ

パラメーター セット

-AllowOutboundHttp

Office Online Serverからの送信 HTTP 接続を許可します。

パラメーターのプロパティ

パラメーター セット

-CacheLocation

表示された画像ファイルを保存するグローバル ディスク キャッシュの場所を指定します。 既定の場所は %programdata%\Microsoft\OfficeWebApps\Working\d\です。

パラメーターのプロパティ

パラメーター セット

-CacheSizeInGB

グローバル ディスク キャッシュの最大サイズをギガバイト単位で指定します。 型は、0 または正の整数の、整数値である必要があります。 既定サイズは 15 GB です。

パラメーターのプロパティ

パラメーター セット

-CertificateName

HTTPS バインドの作成に使用Office Online Server証明書のフレンドリ名を指定します。

指定した証明書が見つからないか期限切れの場合、または、指定した値が複数の証明書に関連付けられている場合は、エラーがログに記録され、ファームは作成されません。

この値は、Office Online Server ファームに参加するすべてのサーバーで使用されます。 つまり、ファーム内のすべてのサーバーがこのフレンドリ名の証明書を持つ必要があります。

AllowHttp または SSLOffloaded パラメーターを使用している場合は、CertificateName パラメーターを指定する必要はありません。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-ClipartEnabled

Office.com から Office ドキュメントにクリップ アートを挿入するためのサポートを有効にします。 この機能には、サーバー間通信が必要です。直接構成するか、Proxy パラメーターを使用して指定したプロキシを使用して構成します。

パラメーターのプロパティ

パラメーター セット

-Confirm

コマンドを実行する前に確認メッセージを表示します。

パラメーターのプロパティ

パラメーター セット

-DocumentInfoCacheSize

メモリ キャッシュに保存されるドキュメント変換レコードの最大数を指定します。

既定値は 5000 レコードです。

パラメーターのプロパティ

パラメーター セット

-EditingEnabled

ブラウザーでの編集のサポートを有効にします。 既定は False です。 編集機能を使用できる適切なライセンス契約を持っている場合にのみ、True に設定します。

パラメーターのプロパティ

パラメーター セット

-ExcelAbortOnRefreshOnOpenFail

データの更新が失敗した場合に、ブックが読み込まれないようにします。 これにより、ユーザーに対して古い情報またはアクセス権がない情報が表示されないようにできます。

パラメーターのプロパティ

パラメーター セット

-ExcelAllowExternalData

ブックに外部データへの接続が含まれているブラウザーで、Excel ブックでサポートされている外部データの更新を有効にします。 既定値は True です。

パラメーターのプロパティ

パラメーター セット

-ExcelAutomaticVolatileFunctionCacheLifeTime

揮発性関数の計算値が自動計算のためにキャッシュされる最大時間 (秒単位) を指定します。

• -1:ブックの読み込み時に計算を 1 回実行します。
• 0: 常に計算を実行します。
• 1 から 2,073,600: 1 秒から 24 日の間、キャッシュします。

パラメーターのプロパティ

パラメーター セット

-ExcelCachingUnusedFiles

Web Excel セッションで使用されなくなったファイルのキャッシュを有効にします。

パラメーターのプロパティ

パラメーター セット

-ExcelChartAndImageSizeMax

ブラウザーで Excel で開くことができるグラフまたは画像の最大サイズをメガバイト単位で指定します。 値は 0 より大きい整数である必要があります。

パラメーターのプロパティ

パラメーター セット

-ExcelConcurrentDataRequestsPerSessionMax

1 つのセッションで同時に許容される外部データ要求の最大数を指定します。 1 つのセッションでこれよりも多くの要求を発行する必要がある場合は、超過分の要求はキューに格納されます。

パラメーターのプロパティ

パラメーター セット

-ExcelConnectionLifetime

ブラウザーでの Excel の外部データ接続の期間を秒単位で指定します。 既定値は 1800 です。

パラメーターのプロパティ

パラメーター セット

-ExcelDefaultWorkbookCalcMode

PARAMVALUE:ファイル | 手動 |自動 |AutoDataTables

パラメーターのプロパティ

パラメーター セット

-ExcelExternalDataCacheLifetime

ブラウザーでの Excel の外部データ キャッシュの有効期間の期間を秒単位で指定します。 既定値は 300 秒です。

パラメーターのプロパティ

パラメーター セット

-ExcelMemoryCacheThreshold

非アクティブなオブジェクトに割り当てることができる最大プライベート バイト数の割合。 メモリ キャッシュのしきい値を超えると、キャッシュに残っている現在使用されていないオブジェクトは解放されます。 有効な値: 0 (非アクティブなオブジェクトのキャッシュを無効にします)。1 から 95 まで。

パラメーターのプロパティ

パラメーター セット

-ExcelPrivateBytesMax

ブラウザーで Excel によって使用される最大プライベート バイトをメガバイト単位で指定します。 -1 を設定した場合、プライベート バイトの最大サイズは、既定でコンピューター上の物理メモリの 50% に設定されます。

この型は、-1 または任意の正の整数であることが必要です。 既定値は -1 です。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-ExcelRequestDurationMax

セッションの 1 つの要求の最大持続時間を秒単位で指定します。 この時間が経過すると、要求はタイムアウトします。

この型は、-1 (無期限)、または 1 ～ 2,073,600 の範囲の整数であることが必要です。 既定値は 300 です。

パラメーターのプロパティ

パラメーター セット

-ExcelRestExternalDataEnabled

REST API からの要求を許可して、外部データ接続を更新します。 [外部データの許可] が None に設定されている場合、この設定は無効になります。 Bool のチェック ボックスをオンにします。 既定値は False です。

パラメーターのプロパティ

パラメーター セット

-ExcelSessionTimeout

ユーザー アクティビティがない場合に、ブラウザーでセッションがアクティブな状態を維持する時間を秒単位で指定します。 有効な値は次のとおりです。

• -1 セッションが期限切れになることはありません。
• 0 セッションは、1 つの要求の終了時に期限切れになります。
• 1 ～ 2,073,600   1 秒～ 24 日の間、アクティブです。

既定値は 450 です。

パラメーターのプロパティ

パラメーター セット

-ExcelUdfsAllowed

ブラウザーで Excel のユーザー定義関数を有効にします。 既定は False です。

パラメーターのプロパティ

パラメーター セット

-ExcelUnusedObjectAgeMax

非アクティブなオブジェクトがメモリ キャッシュに残る最大時間 (分)。 非アクティブなオブジェクトは、セッションで使用されないオブジェクトです。

有効な値:

• -1 (最大値なし)
• 1 から 34560 (24 日)。

既定値は -1 です。

パラメーターのプロパティ

パラメーター セット

-ExcelUseEffectiveUserName

ブラウザーで Excel で Analysis Services EffectiveUserName パラメーターを使用できるようにします。 既定は False です。

パラメーターのプロパティ

パラメーター セット

-ExcelWarnOnDataRefresh

ブラウザーで Excel でデータが更新されたときに表示される警告ダイアログ ボックスをオフまたはオンにします。

パラメーターのプロパティ

パラメーター セット

-ExcelWorkbookSizeMax

読み込み可能なブックの最大サイズ (MB 単位) を指定します。

この型は、1 ～ 2,000 の範囲の整数値であることが必要です。 既定値は 10 です。

パラメーターのプロパティ

パラメーター セット

-ExternalURL

クライアントがインターネットからOffice Online Server ファームにアクセスするために使用する URL ルートを指定します。 負荷分散されたマルチサーバー Office Online Server ファームの場合、外部 URL は外部向けロード バランサーの IP アドレスにバインドされます。

Office Online Server ファームには、少なくとも 1 つの URL が必要です。この URL は、ExternalURL または InternalURL を使用して設定されます。 内部および外部 URL の両方を設定することもできます。

パラメーターのプロパティ

パラメーター セット

-FarmOU

Office Online Server ファームに参加するには、サーバーが のメンバーである必要がある Active Directory 組織単位 (OU) の名前を指定します。 このパラメーターを使用して、承認されていないサーバー (つまり、OU に存在しないサーバー) がOffice Online Server ファームに参加しないようにします。

パラメーターのプロパティ

パラメーター セット

-Force

ユーザー プロンプトを表示せずに、すべての確認に対して [はい] と回答します。

パラメーターのプロパティ

パラメーター セット

-InternalURL

イントラネットからOffice Online Server ファームにアクセスするためにクライアントが使用する必要がある URL ルートを指定します。

Office Online Server ファームには、少なくとも 1 つの URL が必要です。 これは、ExternalURL または InternalURL を使用して設定されます。 内部および外部 URL の両方を設定することもできます。

パラメーターのプロパティ

パラメーター セット

-LogLocation

アクティビティ ログが保存される、ローカル コンピューターでの場所を指定します。

この場所は、ファーム内のすべてのサーバーに適用され、サーバーごとにカスタマイズはできません。 既定の場所は %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\です。

ログが保存されるドライブに、十分な空きディスク領域があることを確認してください。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-LogRetentionInDays

ログ エントリを保持する日数を指定します。 構成された日付より古いログ エントリはトリムされます。

この型は、0 ～ 365 の範囲の整数である必要があります。 既定値は 7 日です。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-LogVerbosity

トレース ログ ファイルに保存される情報の量を指定します。 値は、次のとおりです。

• VerboseEX は、トレース ログ ファイルに (最も情報量が多い) 低レベルの詳細を書き込みます。 大規模になるトレースで役立ちます。
• Verbose は、トレース ログ ファイルに低レベルの詳細を書き込みます。
• Medium は、トレース ログ ファイルに中レベルの詳細を書き込みます。
• High は、トレース ログ ファイルに (情報量が少ない) 高レベルの詳細を書き込みます。
• Monitorable は、監視する必要がある特殊なコード パスおよびアクションを示すトレースを作成します。
• Unexpected は、監視する必要がある予測外のコード パスおよびアクションを示すトレースを作成します。
• None は、トレース ログ ファイルにトレース情報を書き込みません。

LogVerbosity を長時間、低レベルのままにするとパフォーマンスを低下させます。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-MaxMemoryCacheSizeInMB

レンダリング キャッシュが使用できるメモリの最大量をメガバイト単位で指定します。

型は、0 または正の整数の、整数値である必要があります。 既定サイズは 1024 MB です。

パラメーターのプロパティ

パラメーター セット

-MaxTranslationCharacterCount

ドキュメントが翻訳できるようにする目的で、含める文字の最大数を指定します。

型は整数値である必要があります。 設定できる値は、2000 から 2,000,000 で、制限をしない場合は 0 を指定できます。 既定値は 125,000 です。

パラメーターのプロパティ

パラメーター セット

-OpenFromUncEnabled

オンライン ビューアーを使用して UNC パスから Office ファイルを表示するかのオンとオフを切り替えます。

最初に OpenFromUrlEnabled を True に設定し、オンライン ビューアーで UNC パスのファイルを表示できるようにします。

パラメーターのプロパティ

パラメーター セット

-OpenFromUrlEnabled

オンライン ビューアーを使用して URL または UNC パスから Office ファイルを表示する機能をオンまたはオフにします。

パラメーターのプロパティ

パラメーター セット

-OpenFromUrlThrottlingEnabled

特定のサーバーからの Open From URL 要求の数を一定期間で調整します。 構成できない既定の調整値は、Office Online Server ファームが、オンライン ビューアーでコンテンツを表示するための要求で単一のサーバーを圧倒しないようにします。

パラメーターのプロパティ

パラメーター セット

-PicturePasteDisabled

ユーザーが Web ページからブラウザーの Office に画像を貼り付ける機能をオフにします。 既定は False です。 OpenFromURLEnabled が True に設定され、PicturePasteDisabled が False に設定されていない場合、ユーザーはブラウザーで Office にイメージを貼り付けることができます。

パラメーターのプロパティ

パラメーター セット

-Proxy

外部サイトへの HTTP 要求を可能にする目的で構成されたプロキシ サーバーの URL を指定します。 一般的には、ClipartEnabled および TranslationEnabled パラメーターとともに構成されます。

パラメーターのプロパティ

パラメーター セット

-RecycleActiveProcessCount

プロセスがリサイクルされる前に、単一のWordまたはPowerPoint プロセスでレンダリングできるファイルの数を指定します。 この型は、1 ～ 1000 の範囲の整数である必要があります。 既定値は 5 です。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-RemovePersonalInformationFromLogs

Office Online Serverログからの個人情報のベスト エフォート スクラブを提供し、値を SHA256 ハッシュに置き換えます。 Potentially scrubbed information can be:

• ドキュメント名および URL
• IP アドレス
• 電子メール アドレス
• ユーザー名

既定は False です。 このパラメーターを有効にしても、個人情報がOffice Online Server ログに記録されることは保証されません。

パラメーターのプロパティ

パラメーター セット

-RenderingLocalCacheLocation

WordおよびPowerPoint表示サービスで使用する一時キャッシュの場所を指定します。

既定の場所は %programdata%\Microsoft\OfficeWebApps\Working\waccache\です。

パラメーターのプロパティ

パラメーター セット

-S2SCertificateName

SharePoint Server でのサーバー間認証に使用する証明書のフレンドリ名。

パラメーターのプロパティ

パラメーター セット

-SSLOffloaded

SSL がロード バランサーにオフロードされることをOffice Online Server ファーム内のサーバーに示します。 SSLOffloaded が有効にされると、Web アプリケーションは、ローカル サーバーのポート 80 (HTTP) にバインドされます。 しかし、CSS または画像のようなその他のリソースを参照する HTML は、参照に HTTPS URL を使用します。

この変更を有効にするには、ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-TranslationEnabled

各言語間でテキストを翻訳するオンライン サービスである Microsoft Translator を使用する、自動的なドキュメント翻訳のサポートを有効にします。 翻訳されたファイルがWordに表示されます。 Microsoft Translator はオンライン サービスであることから、直接の、または Proxy パラメーターで指定するプロキシを使用する、サーバーから Web への通信を有効にする必要があります。

Microsoft Translator は、翻訳の品質を向上する目的でデータを収集することがあります。

パラメーターのプロパティ

パラメーター セット

-TranslationServiceAddress

翻訳要求の送信先となる翻訳サーバーの URL を指定します。 既定値は Microsoft Translator オンライン サービスです。 通常、翻訳サービスを変更する必要がない限り、このパラメーターは使用しません。

この変更を有効にするには、Office Online Server ファーム内のすべてのサーバーを再起動する必要があります。

パラメーターのプロパティ

パラメーター セット

-TranslationServiceAppId

翻訳サービスのアプリケーション ID を指定します。 既定値は、ブラウザーの Office のパブリック アプリケーション ID です。 通常、追加のサービスについて Microsoft Translator とネゴシエートし、プライベート アプリケーション ID を提供していない限り、このパラメーターは使用しません。

パラメーターのプロパティ

パラメーター セット

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。

パラメーターのプロパティ

パラメーター セット