Compartilhar via

  • Artigo

Get-CsHostingProvider

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os provedores de hospedagem configurados para 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

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

Get-CsHostingProvider [-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 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.

O cmdlet Get-CsHostingProvider permite retornar informações sobre todos os provedores de hospedagem que tiverem sido configurados para uso na organização.

Observe que não é possível estabelecer uma federação com um provedor de hospedagem se seu Servidores de Borda estiver configurado 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 Get-CsHostingProvider localmente: RTCUniversalUserAdmins, 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 "Get-CsHostingProvider"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

Identificador exclusivo do provedor de hospedagem a ser retornado. A Identidade deve ser o nome de domínio totalmente qualificado (FQDN) do provedor de hospedagem (fabrikam.com, por exemplo) ou talvez o nome da empresa que oferece os serviços (Fabrikam, Inc.).

Se esse parâmetro não for especificado, Get-CsHostingProvider retornará uma coleção de todos os provedores de hospedagem configurados para uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar valores curinga para retornar um ou vários provedores de hospedagem. Por exemplo, para retornar todos os provedores de hospedagem que possuírem uma Identidade que termine com o valor de cadeia de caracteres ".com", utilize esta sintaxe: -Filter "*.com". Para retornar todos os provedores de hospedagem que possuírem uma Identidade que comece com a cadeia de caracteres "Fabri", utilize esta sintaxe: -Filter "Fabri*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados do provedor de hospedagem 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-CsHostingProvider não aceita a entrada canalizada.

Tipos de Retorno

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

Exemplo

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

Get-CsHostingProvider

O comando anterior retorna uma coleção de todos os provedores de hospedagem configurados para uso na organização. O ato de chamar Get-CsHostingProvider sem quaisquer parâmetros adicionais retorna a coleção completa de provedores de hospedagem.

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

Get-CsHostingProvider -Identity Fabrikam.com

O Exemplo 2 retorna o provedor de hospedagem que possuir a Identidade Fabrikam.com. Como as Identidades dos provedores de hospedagem devem ser exclusivas, esse comando nunca retornará mais de um único item.

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

Get-CsHostingProvider -Filter *.org

O comando exibido no Exemplo 3 retorna uma coleção de todos os provedores de hospedagem que possuírem uma Identidade que termine com o valor de cadeia de caracteres ".org" (fabrikam.org, contoso.org, etc., por exemplo).

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

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

No Exemplo 4, serão retornados todos os provedores de hospedagem que estiverem habilitados para uso. Para fazer isso, Get-CsHostingProvider é primeiramente chamado para retornar uma coleção de todos os provedores de hospedagem configurados para uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os provedores cuja propriedade Enabled for igual a True.

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

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

O comando anterior retorna todos os provedores de hospedagem que possuírem um espaço de endereço compartilhado e que hospedarem usuários do Lync Server 2010; por definição, isso significa que o comando retorna todos os provedores de hospedagem que fizerem parte da configuração de um "domínio dividido". Os domínios divididos significam que algumas das contas do Lync Server são mantidas no local enquanto outras são mantidas por um provedor de hospedagem. Para realizar essa tarefa, o comando utiliza primeiramente Get-CsHostingProvider, para retornar uma coleção de todos os provedores de hospedagem configurados. 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 Enabled deve ser igual a True e 2) a propriedade EnabledSharedAddressSpace deve ser igual a True.

-------------------------- Exemplo 6 ------------------------

Get-CsHostingProvider | Select-Object *

O comando exibido no Exemplo 6 exibe todos os valores de propriedade de todos os provedores de hospedagem configurados para uso na organização. Por padrão, os valores de propriedade correspondentes a EnabledSharedAddressSpace e HostsOCSUsers não serão exibidos ao se executar Get-CsHostingProvider. Para exibir os valores dessas propriedades, as informações retornadas por Get-CsHostingProvider serão canalizadas para o cmdlet Select-Object. A sintaxe "Select-Object *" instrui Get-CsHostingProvider a exibir todas as propriedades e valores de propriedades dos itens retornados.