Compartilhar via

  • Artigo

New-CsPublicProvider

 

Tópico modificado em: 2012-03-26

Cria uma relação entre federações com um novo provedor público. Um provedor público é uma organização que fornece um sistema de mensagens instantâneas, presença e serviços relacionados ao público geral. O Microsoft Lync Server 2010 vem com três fornecedores públicos configurados, mas não habilitados: Yahoo!, AOL e MSN.

Sintaxe

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

Descrição Detalhada

Federação é um meio pelo qual duas organizações podem configurar uma relação de confiança que facilita a comunicação entre os dois grupos. Quando uma federação for estabelecida, os usuários das duas organizações poderão enviar outras mensagens instantâneas, assinar notificações de presença ou se comunicar entre si usando aplicativos SIP, como o Microsoft Lync 2010. O Lync Server 2010 permite três tipos de federação: 1) federação direta entre sua organização e a outra; 2) federação entre sua organização e um provedor público e 3) federação entre sua organização e um provedor de hospedagem de terceiros.

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

Para se federar com um provedor público, você precisa criar e habilitar um novo provedor público. (Além disso, o provedor público precisará criar uma relação entre federações com você.) O Set-CsPublicProvider permite modificar valores de propriedade de qualquer um dos provedores públicos configurados para uso em sua organização.

Observe não ser possível federar com um provedor público caso os Servidores de Borda estejam configurados para usar o roteamento padrão, e não o roteamento de servidor DNS.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsPublicProvider localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Cadeia de caracteres

Identificador exclusivo do provedor público a ser criado. O parâmetro Identity geralmente é o nome do site que oferece os serviços (por exemplo, Yahoo!, AOL ou MSN).

As identidades devem ser exclusivas não apenas entre os provedores públicos, mas também entre os provedores de hospedagem. Suponhamos que você tente criar um novo provedor público com a Identidade Fabrikam. Haverá falha do comando se já houver um provedor público ou provedor de hospedagem com essa Identidade.

ProxyFqdn

Obrigatório

Fqdn

Especifica o FQDN (nome de domínio totalmente qualificado, como por exemplo, proxyserver.fabrikam.com) do servidor proxy usado pelo provedor público.

Os FQDNs de proxy devem ser exclusivos não apenas entre os provedores públicos, mas também entre os provedores de hospedagem. Por exemplo, suponhamos que você tente criar um novo provedor público com o FQDN de proxy proxyserver.fabrikam.com. Haverá falha do comando se um provedor público ou um provedor de hospedagem com esse FQDN de proxy já existir.

Enabled

Obrigatório

Booleano

Indica se a relação de federação entre a organização e o provedor público está ativa ou não. Se estiver definido como True, os usuários da organização poderão trocar mensagens instantâneas e informações de presença com usuários que tenham contas hospedadas no provedor público. Se estiver definido como False, os usuários da organização não poderão trocar mensagens instantâneas e informações de presença com usuários que tenham contas hospedadas no provedor público. É possível habilitar e desabilitar relações entre federações a qualquer momento, usando-se os cmdlets Enable-CsPublicProvider e Disable-CsPublicProvider, respectivamente.

VerificationLevel

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 como 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 em sua lista de contatos, você poderá receber mensagens dele. Se Pilar Ackerman não estiver em 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

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

InMemory

Parâmetros de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

WhatIf

Parâmetros de opção

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

Confirm

Parâmetros de opção

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

Tipos de Entrada

Nenhuma. New-CsPublicProvider não aceita entrada em pipeline.

Tipos de Retorno

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

Exemplo

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

New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

O comando mostrado no Exemplo 1 cria uma nova relação entre federações com um provedor público com a Identity Fabrikam. Além de especificar a Identidade, dois outros valores de propriedade (e seus parâmetros correspondentes) devem ser definidos: ProxyFqdn (definido como proxyserver.fabrikam.com) e Enabled (que, no caso, está definido como True).

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

$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x

O Exemplo 2 demonstra como é possível criar um novo provedor público apenas na memória, modificar as propriedades desse provedor e transformar esse provedor virtual em um provedor real que possa ser usado na organização. Para isso, o primeiro comando no exemplo cria um provedor público com a Identidade Fabrikam. Além de incluir os parâmetros obrigatórios (Identity, ProxyFqdn e Enabled), o comando adiciona o parâmetro InMemory; isso cria uma instância apenas na memória do provedor que, em seguida, é armazenada em uma variável chamada $x.

Depois que a instância do provedor é criada na memória, o segundo comando no exemplo modifica a propriedade VerificationLevel do provedor virtual. Em seguida, o comando final usa Set-CsPublicProvider para transformar o provedor virtual (armazenado em $x) em um provedor público real. Se você não chamar Set-CsPublicProvider, o provedor real não será criado. Por sua vez, o provedor virtual desaparecerá no momento em que você encerrar sua sessão do Windows PowerShell ou excluir a variável $x.