Export (0) Print
Expand All

New-SPWOPIBinding

Office Web Apps
 

Applies to: SharePoint Server 2013, SharePoint Foundation 2013, Office Web Apps

Topic Last Modified: 2013-12-18

Creates a new binding to associate file name extensions or applications with actions on the current SharePoint farm where this cmdlet is run.

New-SPWOPIBinding -ServerName <String> [-Action <String>] [-AllowHTTP <SwitchParameter>] [-Application <String>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Extension <String>] [-FileName <String>] [-ProgId <String>] [-WhatIf [<SwitchParameter>]]

The New-SPWOPIBinding cmdlet associates file name extensions or applications to actions on the current SharePoint farm where this cmdlet is run. Each binding allows you to use the WOPI application to view or edit files in your SharePoint library. For example, when a user sees a Word document in a SharePoint document list, the SharePoint list will display the available options to view or edit the document based on the actions that are bound to Word on that SharePoint farm.

To use a WOPI application, such as a server that runs Office Web Apps Server, for Office Web Apps, you must run this cmdlet on the SharePoint farm before you can use the Office Web Apps.

If you run New-SPWOPIBinding for an application or file name extension where the binding (or association) already exists, the cmdlet will fail.

 

Parameter Required Type Description

ServerName

Required

System.String

Specifies the name or fully qualified domain name (FQDN) of the WOPI application (such as a server that runs Office Web Apps Server).

Action

Optional

System.String

Specifies the action to bind. For example, “view,” “edit,” and “embedview.” For a list of actions that the WOPI application supports, run Get-SPWOPIBinding. Typically, you will not use this parameter. If you specify some actions but not others, some SharePoint features may not work.

AllowHTTP

Optional

System.Management.Automation.SwitchParameter

Specifies that the cmdlet can use HTTP for discovery of what the WOPI application supports. If this is specified as True, the discovery information from the WOPI application will be sent on a nonsecure connection.

Application

Optional

System.String

Specifies applications to bind. Possible applications are as follows: “Word,” “Excel,” “PowerPoint,” or “OneNote.” Run Get-SPWOPIBinding to get the full list of application the WOPI application supports.

AssignmentCollection

Optional

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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.

NoteNote:
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.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Extension

Optional

System.String

Specifies the file name extensions to bind. Run Get-SPWOPIBinding to get the list of file name extensions the WOPI application supports.

FileName

Optional

System.String

Specifies the path of the xml file that contains the discover information for the WOPI application. You can load discovery information from an xml file instead of requesting from the WOPI application directly.

ProgId

Optional

System.String

Specifies the programmatic identifier (ProgID) for an application to bind. Run Get-SPWOPIBinding to get the list of ProgIDs that the WOPI application supports. You may only want to use this parameter to associate an action to an OneNote folder.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

--------------EXAMPLE 1-----------------

New-SPWOPIBinding -ServerName "Server.corp.Contoso.com"

This example creates bindings for all the applications and file name extensions that the WOPI application supports on the current SharePoint farm where this cmdlet is run.

--------------EXAMPLE 2-----------------

New-SPWOPIBinding -ServerName "Server.corp.Contoso.com" -Application "Excel"

This example associates Excel with all the actions that the WOPI application supports for Excel on the current SharePoint farm where this cmdlet is run.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft