New-SPWOPIBinding

Cria um novo vínculo para associar extensões de nome de arquivo ou aplicativos com ações no farm atual do SharePoint no qual esse cmdlet é executado.

Sintaxe

Default (Default)

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

Description

O New-SPWOPIBinding cmdlet associa extensões de nome de arquivo ou aplicativos a ações no farm atual do SharePoint em que esse cmdlet é executado. Cada vínculo permite o uso do aplicativo WOPI para exibir ou editar arquivos em sua biblioteca do SharePoint. Por exemplo, quando um usuário vê um documento do Word em uma lista de documentos do SharePoint, a lista do SharePoint exibirá as opções disponíveis para exibir ou editar o documento com base nas ações vinculadas ao Word nesse farm do SharePoint.

Para usar um aplicativo WOPI, como um servidor que executa o Servidor de Aplicativos Web do Office, para Aplicativos Web do Office, você deve executar esse cmdlet no farm do SharePoint antes de poder usar os Aplicativos Web do Office.

Se você executar New-SPWOPIBinding uma extensão de nome de arquivo ou aplicativo em que a associação (ou associação) já existe, o cmdlet falhará.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO 1

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

Esse exemplo cria associações com todos os aplicativos e extensões de nome de arquivo com suporte do aplicativo WOPI no farm do SharePoint atual no qual esse cmdlet é executado.

EXEMPLO 2

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

Esse exemplo associa Excel a todas as ações com suporte do aplicativo WOPI para Excel no farm do SharePoint atual no qual esse cmdlet é executado.

Parâmetros

-Action

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a ação a ser vinculada.

Por exemplo, "exibir", "editar" e "incorporarexibir". Para obter uma lista de ações compatíveis com o aplicativo WOPI, execute Get-SPWOPIBinding. Normalmente, não parâmetro não é usado.

Talvez alguns recursos do SharePoint não funcionem se algumas ações forem especificadas sem que outras tenham sido especificadas.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AllowHTTP

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica se o cmdlet pode usar HTTP para descoberta do que é com suporte do aplicativo WOPI.

Se isso for especificado como True, as informações de descoberta do aplicativo WOPI serão enviadas em uma conexão não segura.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Application

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica os aplicativos para vínculo.

As possíveis aplicações são as seguintes: "Word", "Excel", "PowerPoint" ou "OneNote". Execute Get-SPWOPIBinding para obter a lista completa de aplicativos compatíveis com o aplicativo WOPI.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AssignmentCollection

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Extension

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica as extensões de nome do arquivo para vínculo.

Execute Get-SPWOPIBinding para obter a lista de extensões de nome de arquivo compatíveis com o aplicativo WOPI.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FileName

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o caminho do arquivo xml que contém as informações de descoberta do aplicativo WOPI.

É possível carregar as informações de descoberta de um arquivo xml em vez de solicitar diretamente do aplicativo WOPI.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProgId

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o ProgID (identificador programático) de um aplicativo para vínculo.

Execute Get-SPWOPIBinding para obter a lista de ProgIDs compatíveis com o aplicativo WOPI.

Convém usar apenas esse parâmetro para associar uma ação a uma pasta OneNote.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServerName

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome ou o nome de domínio totalmente qualificado (FQDN) do aplicativo WOPI (como um servidor que executa o Servidor do Office Web Apps).

Ele também pode ser um FQDN de um ponto de extremidade com balanceamento de carga para vários servidores do Office Web Aplicativos Web.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.