Compartilhar via

  • Artigo

Disable-CsPublicProvider

 

Tópico modificado em: 2012-03-23

Desabilita um provedor público configurado para uso na 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

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

Disable-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 tenha 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ê). Ao se criar um provedor público, será possível habilitar ou desabilitar esse relacionamento de federação. Se um provedor público for habilitado, os usuários da organização poderão trocar mensagens instantâneas e informações de presença com pessoas que possuírem contas no provedor público. Se um provedor público for desabilitado, a capacidade de se comunicar com pessoas que possuírem contas com o provedor público será suspensa e permanecerá assim até que o provedor seja habilitado novamente. Se precisar suspender temporariamente o relacionamento com o provedor, utilize o cmdlet Disable-CsPublicProvider. Se preferir excluir esse provedor, utilize o cmdlet Remove-CsPublicProvider.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Disable-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 tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

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

Instance

Opcional

Objeto DisplayPublicProvider

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

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. Disable-CsPublicProvider aceita instâncias canalizadas do objeto de provedor público.

Tipos de Retorno

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

Exemplo

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

Disable-CsPublicProvider -Identity "MSN"

O comando anterior desabilita o provedor público cuja Identidade for MSN. Este comando retornará um erro se MSN já estiver desabilitado.

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

Get-CsPublicProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsPublicProvider

O Exemplo 2 desabilita todos os provedores públicos que estiverem habilitados. Para fazer isso, o comando usa primeiramente Get-CsPublicProvider, para retornar uma coleção de todos os provedores públicos em uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os provedores cuja propriedade Enable for igual a True. Por sua vez, esta coleção filtrada será canalizada para Disable-CsPublicProvider, que desabilitará cada provedor na coleção.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsPublicProvider

O comando exibido no Exemplo 3 desabilita todos os provedores públicos que estiverem habilitados e que possuírem um nível de verificação definido como AlwaysVerifiable. Para fazer isso, o comando chama primeiramente Get-CsPublicProvider, para retornar uma coleção de todos os provedores públicos em uso na organização. Esta coleção será então canalizada para Where-Object, que selecionará os provedores que atenderem a dois critérios: 1) a propriedade VerificationLevel deve ser igual a AlwaysVerifiable e 2) a propriedade Enabled deve ser igual a True. (o operador -and informa ao Where-Object que, para serem selecionados, os objetos devem atender a todos os critérios especificados). Esta coleção filtrada será canalizada para Disable-CsPublicProvider, que desabilitará cada provedor nessa coleção.