Compartilhar via

  • Artigo

Set-CsHostingProvider

 

Tópico modificado em: 2012-03-26

Modifica um provedor de hospedagem em uso na organização. Um provedor de hospedagem é uma organização de terceiros que fornece mensagens instantâneas, presença e serviços relacionados a um domínio com o qual se deseja estabelecer federação. Os provedores de hospedagem, como Microsoft Lync Online 2010, diferem dos públicos (como o Yahoo!, MSN e AOL) por seus serviços não serem oferecidos ao público em geral.

Sintaxe

Set-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsHostingProvider [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-Instance <PSObject>] [-IsLocal <$true | $false>] [-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 Lync 2010. O Microsoft 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 de hospedagem é uma organização que presta serviços de comunicação SIP para outras organizações. Por exemplo: Fabrikam, Inc. pode hospedar usuários da Contoso, da Northwind Traders e Wingtip Toys. Quando se estabelece uma relação de federação com um provedor de hospedagem, a federação é efetivamente estabelecida em qualquer organização hospedada por esse provedor. Por exemplo: se você estabelecer uma federação com a Fabrikam, os usuários poderão trocar mensagens instantâneas e informação de presença com os usuários da Contoso, Northwind Traders e Wingtip Toys.

Os provedores de hospedagem são também utilizados em situações onde haja divisão de domínios. Em um situação de divisão de domínios, alguns dos usuários do Lync Server 2010 têm contas hospedadas locais (isto é, hospedadas na implementação local do Lync Server). As contas de outros usuários serão mantidas remotamente pelo provedor de hospedagem de terceiros. A federação com o provedor de hospedagem permite aos usuários locais e remotos se comunicarem entre si.

Para estabelecer uma federação com um provedor de hospedagem de terceiros, é preciso criar e habilitar um novo provedor de hospedagem (além disso, o provedor de terceiros precisará criar um relacionamento de federação com você). Depois que o provedor de hospedagem tiver sido criado, pode-se utilizar o cmdlet Set-CsHostingProvider para modificar as suas propriedades. Por exemplo: é possível utilizar este cmdlet para modificar o FQDN do servidor proxy do provedor ou para modificar o nível de verificação neste provedor.

Observe que não é possível estabelecer uma federação com um provedor de hospedagem se os Servidores de Borda estiverem configurados para utilizar o roteamento padrão, em vez do roteamento de servidor DNS.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Identificador exclusivo do provedor de hospedagem a ser modificado. Identity deve ser o FQDN do provedor de hospedagem (por exemplo, fabrikam.com) ou talvez o nome da empresa que oferece os serviços (Fabrikam, Inc.).

Instance

Opcional

Objeto DisplayHostingProvider

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

AutoDiscoverUrl

Opcional

Cadeia de caracteres

URL do serviço descoberta automática usado por um provedor de hospedagem que hospeda as contas do Lync Server. O serviço descoberta automática permite que os aplicativos cliente, como o Microsoft Lync Mobile, determinem como acessar recursos como o pool doméstico de um usuário.

Enabled

Opcional

Booleano

Indica se a conexão de rede entre o seu domínio e o provedor de hospedagem está habilitada. Não será possível trocar mensagens entre as duas organizações enquanto este valor não estiver definido como True O valor padrão é False.

EnabledSharedAddressSpace

Opcional

Booleano

Se estiver definido como True, indica que o provedor de hospedagem está sendo utilizado em uma situação de divisão de domínios. O valor padrão é False.

HostsOCSUsers

Opcional

Booleano

Se estiver definido como True, indica que o provedor de hospedagem é usado para hospedar contas do Lync Server 2010. Se estiver definido como False, indica que o provedor hospeda outros tipos de contas, como contas do Microsoft Exchange Server. O valor padrão é False.

IsLocal

Opcional

Booleano

Se estiver definido como True, indica que o servidor proxy utilizado pelo provedor de hospedagem está contido na sua topologia do Lync Server. O valor padrão é False.

VerificationLevel

Opcional

Cadeia de caracteres

Indica o nível de verificação permitido de mensagens enviadas de e para o provedor de hospedagem. VerificationLevel deve ser definido com um dos seguintes valores:

AlwaysVerifiable. Indica que todas as mensagens enviadas pelo provedor de hospedagem serão consideradas verificáveis. Isso significa que nenhuma mensagem do provedor de hospedagem será rejeitada.

AlwaysUnverifiable. Indica que todas as mensagens enviadas pelo provedor de hospedagem serão consideradas não-verificáveis. Como resultado, as mensagens serão passadas somente se o usuário no provedor de hospedagem estiver na sua lista de contatos.

UseSourceVerification. Depende do nível de verificação incluído nas mensagens enviadas pelo provedor de hospedagem. Se este nível não for especificado, a mensagem será rejeitada como sendo não-verificável.

O valor padrão é AlwaysVerifiable.

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.DisplayHostingProvider. Set-CsHostingProvider aceita instâncias canalizadas do objeto do provedor de hospedagem.

Tipos de Retorno

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

Exemplo

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

Set-CsHostingProvider -Identity "Fabrikam.com" -VerificationLevel "AlwaysUnverifiable"

O comando anterior modifica o provedor de hospedagem com a identidade Fabrikam.com. Neste exemplo, a propriedade VerificationLevel é definida como AlwaysUnverifiable.

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

Get-CsHostingProvider | Set-CsHostingProvider -VerificationLevel "AlwaysUnverifiable"

O Exemplo 2 é uma variação do comando mostrado no Exemplo 1. Neste caso, contudo, o nível de verificação em todos os provedores de hospedagem é definido como AlwaysUnverifiable. Para fazer isso, utiliza-se primeiramente Get-CsHostingProvider, para retornar uma coleção de todos os provedores de hospedagem configurados para uso na organização. Esta coleção será então canalizada para Set-CsHostingProvider, que modificará a propriedade VerificationLevel em cada provedor da coleção.

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

Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.HostsOCSUsers -eq $True} | Set-CsHostingProvider -EnabledSharedAddressSpace $False -HostsOCSUsers $False

No Exemplo 3, serão modificados todos os provedores de hospedagem configurados para uso em uma configuração de divisão de domínios, de forma que não sejam mais utilizados para federação de divisão de domínios. Neste exemplo, Get-CsHostingProvider é chamado primeiramente para retornar uma coleção de todos os provedores de hospedagem disponíveis. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os provedores que atenderem a dois critérios: 1) a propriedade HostsOCSUsers deve ser igual a True e 2) a propriedade EnabledSharedAddressSpace deve ser igual a True. Esta coleção filtrada será canalizada para Set-CsHostingProvider, que, por sua vez, definirá as propriedades EnabledSharedAddressSpace e HostsOCSUsers como False. Quando se efetua este procedimento, qualquer provedor de hospedagem contido na coleção continuará a ser habilitado para federação. Contudo, eles não serão mais utilizados em uma situação de divisão de domínios.