Set-SPWOPIZone

モジュール:
SharePointServer module

現在の SharePoint ファームがブラウザーを WOPI アプリケーションに移動するときに使用するゾーンを構成します。

構文

Default (既定) 

Set-SPWOPIZone
    [[-Zone] <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

説明

Set-SPWOPIZoneコマンドレットは、現在の SharePoint ファームがブラウザーで WOPI アプリケーション (Office Web Apps Server を実行するサーバーなど) に移動するために使用するゾーンを構成します。 ブラウザーの SharePoint Server ページは、WOPI アプリケーション上のページを含むフレームを作成します。 WOPI アプリケーション ページの URL のゾーンは、この設定によって決まります。

ゾーンを設定しない場合、デフォルトは "internal-HTTPS" です。WOPI アプリケーションでサポートされていないゾーンを選択した場合、Office Web Apps は動作しません。 HTTP を使用するのは、IPSEC (完全な暗号化) が使用されているセキュリティが万全なネットワーク、または機密データが含まれないテスト環境で作業しているときだけにしてください。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例

例文

Set-SPWOPIZone -Zone "external-https"

この例では、HTTPS 経由で WOPI アプリケーション (Office Web Apps Server が実行されているサーバーなど) に外部接続するように現在の SharePoint ファームを構成します。

パラメーター

-AssignmentCollection

適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

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

型:SPAssignmentCollection
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

コマンドを実行する前に確認メッセージを表示します。 詳細については、コマンド get-help about_commonparameters を入力してください。

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Zone

適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

ゾーンを指定します。 WOPI アプリケーションがサポートするゾーンの一覧については、 Get-SPWOPIBinding を実行します。

内部と外部に SharePoint ファームがある場合は、External を指定します。 内部にしか SharePoint ファームがない場合は、Internal を指定します。 HTTP を使用するのは、IPSEC (完全な暗号化) が使用されているセキュリティが万全なネットワーク、または機密データが含まれないテスト環境で作業しているときだけにしてください。 オプションは次のとおりです。

  • Internal-HTTP
  • internal-https
  • 外部-HTTP
  • 外部-HTTPS

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

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。