Compartilhar via

  • Artigo

Enable-CsHostingProvider

 

Tópico modificado em: 2012-03-23

Permite que um provedor de hospedagem seja usado na organização. Um provedor de hospedagem é uma organização de terceiros que fornece sistema de mensagens instantâneas, serviços de presença e relacionados para um domínio com o qual você gostaria de se federar. Os provedores de hospedagem, como o Microsoft Lync Online 2010, são diferentes dos provedores públicos (como Yahoo!, MSN e AOL) porque seus serviços não são prestados ao público em geral.

Sintaxe

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

Enable-CsHostingProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 trocar mensagens instantâneas entre si, assinar notificações de presença ou se comunicar entre si usando aplicativos SIP, como o Microsoft Lync 2010. O Microsoft 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 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 da Wingtip Toys. Ao estabelecer uma relação entre federações com um provedor de hospedagem, você estabelece efetivamente a federação com qualquer organização hospedada por esse provedor. Por exemplo, se você se federar com a Fabrikam, seus usuários poderão trocar mensagens instantâneas e informações de presença com usuários da Contoso, da Northwind Traders e da Wingtip Toys.

Os provedores de hospedagem também são usados em cenários de domínio dividido. Em um cenário de domínio dividido, alguns dos usuários do Lync Server 2010 têm contas hospedadas locais (ou seja, hospedadas na implementação local do Lync Server). Outros usuários têm suas contas hospedadas fora do local pelo provedor de hospedagem de terceiros. A federação com o provedor de hospedagem permite que os usuários locais e fora do local se comuniquem uns com os outros.

Para se federar com um provedor de hospedagem de terceiros, você precisa criar e habilitar um novo provedor de hospedagem. (Além disso, o provedor de terceiros precisará criar uma relação entre federações com você.) É possível habilitar um provedor de hospedagem no momento da criação do provedor; também é possível habilitar o provedor depois do fato usando o cmdlet Enable-CsHostingProvider

Observe que não será possível federar com um provedor de hospedagem se seu Servidores de Borda estiver configurado para usar o roteamento padrão ao invés do roteamento do servidor DNS.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Identificador exclusivo do provedor de hospedagem a ser habilitado. O parâmetro Identity pode ser o FQDN (nome de domínio totalmente qualificado) do provedor de hospedagem (por exemplo, fabrikam.com) ou talvez o nome da empresa que presta 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.

Force

Opcional

Parâmetros de opção

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

WhatIf

Opcional

Parâmetros de opção

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

Confirm

Opcional

Parâmetros de opção

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider. Enable-CsHostingProvider aceita instâncias em pipeline do objeto de provedor de hospedagem.

Tipos de Retorno

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

Exemplo

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

Enable-CsHostingProvider -Identity Fabrikam.com

No Exemplo 1, o provedor de hospedagem com a Identidade Fabrikam.com está habilitado para uso. Observe que esse comando retornará um erro se Fabrikam.com já estiver habilitado para uso.

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

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

O Exemplo 2 mostra como é possível habilitar todos os provedores de hospedagem atualmente desabilitados. Para isso, o comando chama inicialmente Get-CsHostingProvider sem nenhum parâmetro adicional para retornar uma coleção de todos os provedores de hospedagem atualmente configurados para uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona qualquer provedor no qual a propriedade Enabled seja igual a False; por definição, qualquer provedor desabilitado no momento. Essa coleção filtrada é então redirecionada para Enable-CsHostingProvider, que habilita cada um dos provedores da coleção.

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

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

No Exemplo 3, todos os provedores de hospedagem usados em uma configuração de "domínio dividido" estão habilitados para uso. (domínio dividido significa que algumas de suas contas do Lync Server são mantidas locais, enquanto outras contas são mantidas por um provedor de hospedagem). Para realizar essa tarefa, o comando usa inicialmente Get-CsHostingProvider para retornar uma coleção de todos os provedores de hospedagem configurados no momento. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que só seleciona os provedores que atendam a dois critérios: 1) a propriedade EnabledSharedAddressSpace é igual a True e 2) a propriedade Enabled é igual a False. Depois disso, a coleção filtrada é redirecionada para Enable-CsHostingProvider, que habilita cada provedor na coleção.