Compartilhar via


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 (Padrão)

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 ficheiro ou aplicações a ações no farm atual do SharePoint onde este 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 utilizador vê um documento Word numa lista de documentos do SharePoint, a lista do SharePoint apresentará as opções disponíveis para ver ou editar o documento com base nas ações que estão vinculadas a Word nesse farm do SharePoint.

Para utilizar uma aplicação WOPI, como um servidor que executa o Office Aplicativos Web Server, para o Office Aplicativos Web, tem de executar este cmdlet no farm do SharePoint antes de poder utilizar o Office Aplicativos Web.

Se executar New-SPWOPIBinding uma extensão de nome de ficheiro ou aplicação em que o enlace (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, "ver", "editar" e "embedview". Para obter uma lista das ações suportadas pela aplicação 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 aplicações possíveis são as seguintes: "Word", "Excel", "PowerPoint" ou "OneNote". Execute Get-SPWOPIBinding para obter a lista completa da aplicação que a aplicação WOPI suporta.

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 ficheiro que a aplicação WOPI suporta.

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 que a aplicação WOPI suporta.

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).

Também pode ser um FQDN de um ponto final com balanceamento de carga para vários servidores do Office 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.