Compartilhar via

  • Artigo

Enable-CsPublicProvider

 

Tópico modificado em: 2012-03-23

Habilita 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

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

Enable-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 em 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ê.) Os provedores públicos podem ser habilitados quando forem criados ou, posteriormente, utilizando-se o cmdlet Enable-CsPublicProvider.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Enable-CsPublicProvider localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Identificador exclusivo do provedor público a ser habilitado. A Identidade é normalmente o nome do website que fornece os serviços (por exemplo, Yahoo!, AOL e MSN).

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

Tipos de Retorno

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

Exemplo

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

Enable-CsPublicProvider -Identity "MSN"

O comando apresentado no Exemplo 1 habilita o provedor público cuja identidade for MSN. Este comando retornará um erro se o MSN já estiver habilitado.

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

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

O comando anterior habilita todos os provedores públicos que estiverem desabilitados. Para realizar essa tarefa, o comando chama primeiramente Get-CsPublicProvider, retornando uma coleção de todos os provedores públicos configurados para uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os provedores cuja propriedade Enabled for igual a False. Esta coleção filtrada será canalizada para Enable-CsPublicProvider, que habilitará cada provedor na coleção.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable" -and $_.Enabled -eq $False} | Enable-CsPublicProvider

O Exemplo 3 habilita todos os provedores públicos que não estiverem habilitados, contanto que o nível de verificação desses provedores esteja definido como AlwaysVerifiable. Para fazer isso, o comando chama primeiramente Get-CsPublicProvider, retornando uma coleção de todos os provedores públicos em uso na organização. Esta coleção será 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 False. (o operador -and informa a Where-Object que, para serem selecionados, os objetos devem atender a todos os critérios especificados). Esta coleção filtrada será canalizada para Enable-CsPublicProvider, que habilitará cada provedor na coleção.