Compartilhar via

  • Artigo

Remove-CsPublicProvider

 

Tópico modificado em: 2012-03-26

Remove um provedor público configurado para uso em sua organização. Um provedor público é uma organização que fornece ao público em geral mensagens instantâneas, presença e serviços relacionados. O Microsoft Lync Server 2010 é enviado com três provedores públicos configurados, mas não habilitados: Yahoo!, AOL e MSN.

Sintaxe

Remove-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A federação é uma forma segundo a qual duas organizações podem definir uma relação de confiança que facilita a comunicação entre si. Quando se estabelece uma federação, os usuários nas duas organizações podem enviar mensagens instantâneas entre si, se registrar para notificação de presença e se comunicar entre si utilizando aplicativos SIP como o Microsoft Lync 2010. O Lync Server 2010 permite três tipos de federação: 1) federação direta entre uma organização e a outra, 2) federação entre uma organização e um provedor público e 3) federação entre uma organização e um provedor de hospedagem de terceiros.

Um provedor público é uma organização que fornece serviços de comunicação SIP para o público em geral. Quando se estabelece uma relação de federação com um provedor público, a federação é efetivamente estabelecida com qualquer usuário que possua uma conta hospedada por esse provedor. Por exemplo, se você estabelecer uma federação com o MSN, os usuários serão capazes de trocar mensagens instantâneas e informações de presença com qualquer um que tenha uma conta de mensagens instantâneas do MSN.

Para estabelecer uma federação com um provedor público, é preciso criar e habilitar um novo provedor público. (além disso, o provedor público precisará criar um relacionamento de federação com você.) Se, posteriormente, você decidir terminar esse relacionamento, utilize o cmdlet Remove-CsPublicProvider, para excluir o provedor público. Ao excluir um provedor público, ele será removido da lista de parceiros federados; a partir daí, a única forma de restabelecer o relacionamento consiste em recriar o provedor. Se, em vez disso, você optar por suspender temporariamente o relacionamento, utilize o cmdlet Disable-CsPublicProvider. Quando um provedor público for desabilitado, ele não será excluído da lista de parceiros federados; em vez disso, ele será simplesmente marcado como desabilitado e a comunicação entre a organização e esse provedor será suspensa. Para restabelecer o relacionamento, pode-se utilizar Enable-CsPublicProvider para reabilitar o provedor.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsPublicProvider localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPublicProvider"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Cadeia de caracteres

Identificador exclusivo do provedor público a ser removido. Normalmente, a Identidade é o nome do website que oferece os serviços (por exemplo: Yahoo!, AOL, MSN, etc.).

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider. Remove-CsPublicProvider aceita instâncias canalizadas do objeto de provedor público.

Tipos de Retorno

Nenhuma. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Exemplo

-------------------------- Exemplo 1 ------------------------

Remove-CsPublicProvider -Identity "MSN"

O comando anterior exclui o provedor público cuja Identidade for MSN. Depois que este comando tiver sido concluído, MSN não aparecerá mais na lista de provedores públicos configurados. Nesse momento, a única maneira de restabelecer a federação com MSN é recriando o provedor.

-------------------------- Exemplo 2 ------------------------

Get-CsPublicProvider | Remove-CsPublicProvider

O Exemplo 2 exclui todos os provedores públicos configurados para uso na organização. Para fazer isso, o comando usa primeiramente Get-CsPublicProvider, para retornar uma coleção de todos os provedores públicos configurados. Esta coleção será então canalizada para Remove-CsPublicProvider, que, por sua vez, excluirá cada provedor na coleção.

-------------------------- Exemplo 3 ------------------------

Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsPublicProvider

No Exemplo 3, todos os provedores públicos que estiverem desabilitados serão removidos do conjunto de provedores públicos configurados. Para realizar essa tarefa, o comando usa primeiramente Get-CsPublicProvider, para retornar uma coleção de todos os provedores públicos configurados. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os provedores cuja propriedade Enable for igual a False. Esta coleção filtrada será então canalizada para Remove-CsPublicProvider, que excluirá todos os itens na coleção.