New-SPWOPIBinding
このコマンドレットが実行されている現在の SharePoint ファームで、新しいバインドを作成し、ファイル名拡張子またはアプリケーションとアクションを関連付けます。
構文
New-SPWOPIBinding
-ServerName <String>
[-Action <String>]
[-AllowHTTP]
[-Application <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Extension <String>]
[-FileName <String>]
[-ProgId <String>]
[-WhatIf]
[<CommonParameters>]説明
コマンドレットは New-SPWOPIBinding 、ファイル名拡張子またはアプリケーションを、このコマンドレットが実行されている現在の SharePoint ファーム上のアクションに関連付けます。
各バインドを使用することで、WOPI アプリケーションを使って、SharePoint ライブラリにあるファイルを表示または編集できます。
たとえば、ユーザーが SharePoint ドキュメント リストに Word 文書を表示すると、SharePoint リストには、その SharePoint ファームで Word にバインドされているアクションに基づいてドキュメントを表示または編集するための使用可能なオプションが表示されます。
Office Web Apps Server を実行するサーバーなどの WOPI アプリケーションを Office Web Apps用に使用するには、Office Web Appsを使用する前に SharePoint ファームでこのコマンドレットを実行する必要があります。
バインド (または関連付け) が既に存在するアプリケーションまたはファイル名拡張子に対してを実行 New-SPWOPIBinding すると、コマンドレットは失敗します。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
------------------ 例 1 -----------------------
New-SPWOPIBinding -ServerName "Server.corp.Contoso.com"この例では、このコマンドレットが実行されている現在の SharePoint ファームで、WOPI アプリケーションがサポートするすべてのアプリケーションとファイル名拡張子に対してバインドを作成します。
------------------ 例 2 -----------------------
New-SPWOPIBinding -ServerName "Server.corp.Contoso.com" -Application "Excel"この例では、このコマンドレットが実行されている現在の SharePoint ファームで、Excel と、WOPI アプリケーションがサポートする Excel のすべてのアクションを関連付けます。
パラメーター
-Action
バインドするアクションを指定します。
たとえば、"view"、"edit"、"embedview" などです。WOPI アプリケーションでサポートされるアクションの一覧については、 を実行 Get-SPWOPIBindingします。
通常、このパラメーターは使用しません。
一部のアクションを指定しても、他のアクションを指定しない場合は、一部の SharePoint 機能が機能しない可能性があります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AllowHTTP
WOPI アプリケーションでサポートされる情報を、HTTP を使用して検出できるように指定します。
True が指定されていると、WOPI アプリケーションからの検出情報が保護なしの接続で送信されます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Application
バインドするアプリケーションを指定します。
使用できるアプリケーションは、"Word"、"Excel"、"PowerPoint"、または "OneNote" です。を実行 Get-SPWOPIBinding して、WOPI アプリケーションでサポートされているアプリケーションの完全な一覧を取得します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Extension
バインドするファイル名拡張子を指定します。
を実行 Get-SPWOPIBinding して、WOPI アプリケーションでサポートされているファイル名拡張子の一覧を取得します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-FileName
WOPI アプリケーションの検出情報が格納されている xml ファイルのパスを指定します。
検出情報は、WOPI アプリケーションに直接要求するのではなく、xml ファイルから読み込むことができます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ProgId
バインドするアプリケーションのプログラム識別子 (ProgID) を指定します。
を実行 Get-SPWOPIBinding して、WOPI アプリケーションでサポートされている ProgID の一覧を取得します。
このパラメーターを使用して、アクションを OneNote フォルダーに関連付けるだけでもかまいません。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ServerName
WOPI アプリケーション (Office Web Apps Server が実行されているサーバーなど) の名前または完全修飾ドメイン名 (FQDN) を指定します。
複数の Office Web Apps サーバーの負荷分散エンドポイントの FQDN を指定することもできます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |