New-SPWOPISuppressionSetting

モジュール:
SharePointServer module

現在の SharePoint ファームで指定したアクション、ファイル名拡張子、またはプログラム識別子に対して Office Web Apps を無効にします。

構文

Default (既定) 

New-SPWOPISuppressionSetting
    [-Action <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Extension <String>]
    [-ProgId <String>]
    [-WhatIf]
    [<CommonParameters>]

説明

New-SPWOPISuppressionSettingコマンドレットは、現在の SharePoint ファームで指定したアクション、ファイル名拡張子、またはプログラム識別子 (ProgId) の Office Web Apps をオフにします。 このコマンドレットは、検出情報や、ユーザーが SharePoint のリンクによる共有機能を使用してドキュメントへのリンクを送信し、受信者がそのドキュメントの種類に Office Web Apps を使用できるようにする機能を削除せずに、これを実行します。 Excel Services を使用して、WOPI アプリケーション (Office Web Apps Server など) ではなく Excel ブックを表示する場合は、このコマンドレットの使用が必要になることがあります。

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

例

例文

New-SPWOPISuppressionSetting -Extension "XLSX" -Action "view"
New-SPWOPISuppressionSetting -Extension "XLS" -Action "view"

この例では、ファイル名拡張子が ".xlsx" または ".xls" の Excel ブックを、ユーザーが Office Web Apps を使用して表示する機能をオフにします。

パラメーター

-Action

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

特定の拡張機能またはプログラム識別子 (ProgId) に対して抑制する操作を指定します。

たとえば、"view"、"edit"、"embedview" などです。アクションの完全な一覧については、 Get-SPWOPIBinding を実行してください。

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

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

パラメーター セット

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

-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

-Extension

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

抑制するファイル名拡張子を指定します。

Get-SPWOPIBindingを実行して、WOPI アプリケーションがサポートするファイル名拡張子の一覧を取得します。

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

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

パラメーター セット

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

-ProgId

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

抑制するアプリケーションのプログラム識別子 (ProgId) を指定します。

Get-SPWOPIBindingを実行して、WOPI アプリケーションがサポートする ProgId の一覧を取得します。

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

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

パラメーター セット

(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

CommonParameters

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