Compartilhar via

  • Artigo

Get-CsPublicProvider

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os provedores públicos configurados 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

Get-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPublicProvider [-Filter <String>] [-LocalStore <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ê). O cmdlet Get-CsPublicProvider permite retornar informações sobre os provedores públicos que tiverem sido configurados para uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsPublicProvider localmente: RTCUniversalUserAdmins, 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 "Get-CsPublicProvider"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

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

Não é possível usar caracteres curinga ao se especificar a Identidade. Para usar caracteres curinga para retornar um ou vários provedores públicos, use o parâmetro Filter em vez disso.

Filter

Opcional

Cadeia de caracteres

Permite utilizar valores curinga para retornar um ou vários provedores públicos. Por exemplo: para retornar uma coleção de todos os provedores públicos que possuírem uma Identidade que comece com a letra Y, use essa sintaxe: -Filter "Y*". Para retornar uma coleção de todos os provedores públicos que incluírem o valor de cadeia de caracteres "Windows" em qualquer posição de sua Identidade, use essa sintaxe: -Filter "*Windows*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados do provedor público na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsPublicProvider não aceita a entrada canalizada.

Tipos de Retorno

Retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Exemplo

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

Get-CsPublicProvider

O comando exibido no Exemplo 1 retorna uma coleção de todos os provedores públicos que estiverem configurados para uso na organização. O ato de chamar Get-CsPublicProvider sem quaisquer parâmetros adicionais sempre retornará a coleção completa de provedores públicos.

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

Get-CsPublicProvider -Identity "MSN"

No Exemplo 2, serão retornados todos os provedores públicos que possuírem a Identidade MSN. Como as Identidades dos provedores públicos (e dos provedores de hospedagem) devem ser exclusivas, esse comando sempre retornará, no máximo, um único item.

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

Get-CsPublicProvider -Filter W*

O comando anterior retorna todos os provedores públicos que possuírem uma Identidade que comece com a letra W. Isso é feito incluindo-se o parâmetro Filter e o valor do filtro "W*".

-------------------------- Exemplo 4 ------------------------

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

O comando exibido no Exemplo 4 retorna uma coleção de todos os provedores públicos que estiverem desabilitados. Para fazer isso, o comando chama primeiramente Get-CsPublicProvider, para retornar 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 Enable for igual a False.

-------------------------- Exemplo 5 ------------------------

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"}

O comando anterior retorna todos os provedores públicos cuja propriedade VerificationLevel tiver sido definida como AlwaysUnverifiable ou UseSourceVerification. (os níveis de verificação podem ser definidos como AlwaysUnverifiable, UseSourceVerification ou AlwaysVerifiable.) Para fazer isso, o comando chama primeiramente Get-CsPublicProvider, para retornar uma coleção de todos os provedores públicos configurados para uso na organização. Essa coleção será canalizada para o cmdlet Where-Object, que selecionará somente os provedores cuja propriedade VerificationLevel não for igual a AlwaysVerifiable. O resultado: serão selecionados apenas os provedores cuja propriedade VerificationLevel for definida como AlwaysUnverifiable ou UseSourceVerification.