New-OfficeWebAppsFarm

構文

Default (既定)

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]

説明

例

例 1

New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true

パラメーター

-AllowCEIP

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

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

パラメーター セット

-AllowHttp

HTTP アクセス用にポート 80 上で IIS サイトをプロビジョニングする必要があることを示します。 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

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

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

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

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

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

パラメーター セット

-ClipartEnabled

Office ドキュメントに Bing 画像を挿入するためのサポートを有効にします。 この機能を使用するには、直接、または Proxy パラメーターを使用して指定したプロキシを使用して構成された、サーバーと Web 間の通信が必要です。

Bing 画像が機能するためには、OpenFromUrlEnabled パラメーターを True に設定する必要があります。 既定は False です。

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

パラメーター セット

-Confirm

コマンドを実行する前に確認メッセージを表示します。 詳細を表示するには、「get-help about_commonparameters」と入力します。

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

パラメーター セット

-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

ユーザー アクティビティがないときに、ブラウザーの Excel でセッションがアクティブのままである時間 (秒) を指定します。 有効な値は次のとおりです。

• -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 ファームには、ExternalURL または InternalURL を使用して設定された少なくとも 1 つの URL が必要です。 内部および外部 URL の両方を設定することもできます。

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

パラメーター セット

-FarmOU

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

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

パラメーター セット

-Force

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

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

パラメーター セット

-InternalURL

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

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

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

パラメーター セット

-LogLocation

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

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

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

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

パラメーター セット

-LogRetentionInDays

ログ エントリを保持する日数を指定します。 構成された日付より古いログ エントリはトリムされます。 この型は、0 ～ 365 の範囲の整数である必要があります。 既定値は 7 日です。

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

パラメーター セット

-LogVerbosity

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

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

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

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

パラメーター セット

-MaxMemoryCacheSizeInMB

レンダリング キャッシュが使用できるメモリの最大量をメガバイト単位で指定します。 型は、0 または正の整数の、整数値である必要があります。 既定サイズは 75 MB です。

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

パラメーター セット

-MaxTranslationCharacterCount

ドキュメントが翻訳できるようにする目的で、含める文字の最大数を指定します。 型は整数値である必要があります。 設定できる値は、2000 から 2,000,000 で、制限をしない場合は 0 を指定できます。 既定値は 125,000 です。

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

パラメーター セット

-OpenFromUncEnabled

オンライン ビューアーを使用して UNC パスから Office ファイルを表示するかのオンとオフを切り替えます。 最初に OpenFromUrlEnabled を True に設定し、オンライン ビューアーで UNC パスのファイルを表示できるようにします。

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

パラメーター セット

-OpenFromUrlEnabled

オンライン閲覧者を使用して URL または UNC パスから Office ファイルを表示する機能を有効または無効にします。 既定は False です。 ClipartEnabled を使用する場合は、このパラメーターを True に設定する必要があります。

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

パラメーター セット

-OpenFromUrlThrottlingEnabled

一定期間の特定のサーバーからの Open From URL 要求の数を調整します。 既定の調整値は構成不可であり、コンテンツを表示するための要求で Office Online Server ファームが 1 台のサーバーを圧倒しないようにします。

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

パラメーター セット

-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 オンライン サービスです。 通常、翻訳サービスを変更する必要がある場合を除き、このパラメーターは使用しません。

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

パラメーター セット

-TranslationServiceAppId

翻訳サービスのアプリケーション ID を指定します。 既定値は、ブラウザーでの Office のパブリック アプリケーション ID です。 通常、追加のサービスについて Microsoft Translator と交渉し、外部のアプリケーション ID を提供している場合を除き、このパラメーターは使用されません。

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

パラメーター セット

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細を表示するには、「get-help about_commonparameters」と入力します。

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

パラメーター セット