Remove-SPWOPIBinding
Removes bindings for applications, file name extensions and their associated actions on the current SharePoint farm where this cmdlet is run.
Syntax
Identity
Remove-SPWOPIBinding
[[-Identity] <SPWopiBindingPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Filter
Remove-SPWOPIBinding
[-Action <String>]
[-Application <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Extension <String>]
[-ProgId <String>]
[-Server <String>]
[-WhatIf]
[-WOPIZone <String>]
[<CommonParameters>]
RemoveAll
Remove-SPWOPIBinding
[-All]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
The Remove-SPWOPIBinding cmdlet removes bindings for applications, file name extensions and their associated actions on the current SharePoint farm where this cmdlet is run.
After you run this cmdlet, you can use New-SPWOPIBinding to re-create the bindings as needed.
If you remove all the bindings for an application, users cannot use Office Web Apps or the SharePoint Share by link feature for that application.
If you remove all the bindings on the SharePoint farm where this cmdlet is run, users cannot use Office Web Apps or the SharePoint Share by link feature for any applications in the SharePoint library.
If you want to stop using Office Web Apps for default clicks, but must preserve the bindings' discovery information and the ability for users to use the SharePoint Share by link feature to send a link to a document and allow the recipient to use Office Web Apps for that document type, use the New-SPWOPISuppression cmdlet instead.
For permissions and the most current information about Windows PowerShell for SharePoint Products, see the online documentation at SharePoint Server Cmdlets.
Examples
EXAMPLE 1
Remove-SPWOPIBinding -Application "Excel"
This example removes all bindings for Excel on the current SharePoint farm where this cmdlet is run.
EXAMPLE 2
Remove-SPWOPIBinding -All:$true
This example removes all bindings on the current SharePoint farm where this cmdlet is run.
EXAMPLE 3
Get-SPWOPIBinding -Action "MobileView" | Remove-SPWOPIBinding
This example removes all bindings for Office Mobile Web Apps on the current SharePoint farm where this cmdlet is run.
Parameters
-Action
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies the action to remove bindings for.
For example, "view," "edit," and "embedview." For a list of actions run Get-SPWOPIBinding.
Most typically you will not use this parameter.
If you specify some actions but not others, some features in SharePoint may not work.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-All
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Removes all bindings.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
RemoveAll
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Application
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies application to remove bindings for.
Possible applications are as follows: "Word," "Excel," "PowerPoint," or "OneNote." Run Get-SPWOPIBinding to get the list of applications.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AssignmentCollection
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.
When the Global parameter is used, all objects are contained in the global store.
If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.
Parameter properties
| Type: | SPAssignmentCollection |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Prompts you for confirmation before executing the command.
For more information, type the following command: get-help about_commonparameters.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Extension
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies the file name extensions to remove bindings for.
Run Get-SPWOPIBinding to get the list of file name extensions.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies the binding.
Parameter properties
| Type: | SPWopiBindingPipeBind |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Identity
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProgId
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies the programmatic identifier (ProgID) for an application to remove bindings for.
Run Get-SPWOPIBinding to get the list of ProgIDs.
You may only want to use this parameter to remove bindings for OneNote.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Server
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies the name of WOPI application (like Office Web Apps Server) to remove bindings for.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Displays a message that describes the effect of the command instead of executing the command.
For more information, type the following command: get-help about_commonparameters
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WOPIZone
Applicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifies the zone to remove bindings for.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.