Compartilhar via

  • Artigo

Set-CsPublicProvider

 

Tópico modificado em: 2012-03-25

Modifica 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

Set-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-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 (dependendo de como tiver configurado o sistema), 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 Lync Server inclui três provedores públicos (Yahoo!, AOL e MSN) pré-configurados. À medida que os provedores públicos se tornam disponíveis, criam-se relacionamentos de federação com esses novos provedores, utilizando-se o cmdlet New-CsPublicProvider. Depois que os relacionamentos federados tiverem sido estabelecidos, será possível usar Set-CsPublicProvider para modificar dois valores de propriedade importantes desses relacionamentos: Enabled e VerificationLevel.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

Identificador exclusivo do provedor público a ser modificado. 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.

Enabled

Opcional

Parâmetro de opção

Indica se o relacionamento de federação entre a sua organização e o provedor público está ou não ativo. Se for definido como True, os usuários em sua organização poderão trocar mensagens instantâneas e informações de presença com usuários que possuírem contas hospedadas no provedor público. Se for definido como False, os usuários em sua organização não poderão trocar mensagens instantâneas e informações de presença com usuários que possuírem contas hospedadas no provedor público.

VerificationLevel

Opcional

Cadeia de caracteres

Indica como (ou se) as mensagens enviadas de um provedor público são verificadas para garantir que elas tenham sido enviadas desse provedor. VerificationLevel deve ser definido com um dos seguintes valores:

AlwaysVerifiable. Todas as mensagens enviadas propositalmente desse provedor serão aceitas. Se não for encontrado um cabeçalho de verificação na mensagem, ele será adicionado por Lync Server 2010. Esse é o valor padrão.

AlwaysUnverifiable. Todas as mensagens enviadas propositalmente de um servidor público são consideradas não verificadas. Elas só serão entregues se tiverem sido enviadas por uma pessoa que esteja na lista de contatos do destinatário. Por exemplo: se Ken Myer estiver na sua lista de contatos, você poderá receber mensagens dele. Se Pilar Ackerman não estiver na sua lista de contatos, você não poderá receber mensagens dela.

UseSourceVerification. Usa o cabeçalho de verificação adicionado à mensagem pelo provedor público. Se as informações de verificação não forem encontradas, a mensagem será rejeitada.

Force

Opcional

Parâmetro de opção

Suprime os prompts de confirmação ou mensagens de erro não fatal que podem ocorrer quando você executa o cmdlet.

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

Tipos de Retorno

Set-CsPublicProvider não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Exemplo

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

Set-CsPublicProvider -Identity "MSN" -VerificationLevel "UseSourceVerification"

O comando anterior define VerificationLevel para o provedor público cuja Identidade for MSN. Isto é feito incluindo-se o parâmetro VerificationLevel e o valor de parâmetro UseSourceVerification.

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

Get-CsPublicProvider | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

No Exemplo 2, modifica-se o nível de verificação de todos os provedores públicos em uso na organização. Para fazer isso, o comando chama primeiramente Get-CsPublicProvider, sem qualquer parâmetro adicional, para retornar uma coleção de todos os provedores públicos configurados para uso. Esta coleção será então canalizada para Set-CsPublicProvider, que tratará cada provedor na coleção, alterando o valor da propriedade VerificationLevel para UseSourceVerification.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable"} | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

O comando exibido no Exemplo 3 modifica o nível de verificação de todos os provedores públicos cujo nível estiver definido como 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. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os provedores cuja propriedade VerificationLevel for igual a AlwaysVerifiable. Por sua vez, essa coleção filtrada será canalizada para Set-CsPublicProvider, que alterará VerificationLevel de cada provedor na coleção para UseSourceVerification.