Compartilhar via

  • Artigo

Remove-CsHostingProvider

 

Tópico modificado em: 2012-03-25

Remove um ou mais provedores de hospedagem em uso pela 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

Remove-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 o 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 têm contas hospedadas locais (isto é, hospedadas na implementação local de Lync Server 2010). Outros usuários têm suas contas mantidas fora 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ê.) Se, posteriormente, você decidir terminar esse relacionamento, utilize o cmdlet Remove-CsHostingProvider, para excluir o provedor de hospedagem. Ao se excluir um provedor de hospedagem, ele será removido da lista de parceiros federados; a partir daí, a única forma de restabelecer o relacionamento consiste em recriar o provedor. Se, em vez disso, você optar por suspender temporariamente um relacionamento, utilize o cmdlet Disable-CsHostingProvider. Quando um provedor de hospedagem for desabilitado, ele não será excluído da lista de parceiros federados; em vez disso, ele será simplesmente marcado como desabilitado e a comunicação entre a organização e esse provedor será desabilitada. Para restabelecer o relacionamento, pode-se simplesmente utilizar Enable-CsHostingProvider para reabilitar o provedor.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Cadeia de caracteres

Identificador exclusivo do provedor de hospedagem a ser removido. A Identidade é um valor de cadeia de caracteres; a Identidade 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.).

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. Remove-CsHostingProvider aceita instâncias em pipeline do objeto do provedor de hospedagem.

Tipos de Retorno

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

Exemplo

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

Remove-CsHostingProvider -Identity "Fabrikam.com"

O comando apresentado no Exemplo 1 exclui o provedor de hospedagem com a identidade Fabrikam.com. Depois que o provedor de hospedagem tiver sido excluído, será terminada a federação com o Fabrikam.com (e quaisquer domínios associados com Fabrikam.com).

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

Get-CsHostingProvider | Remove-CsHostingProvider

O Exemplo 2, exclui todos os provedores de hospedagem configurados para uso na organização. Para fazer isso, o comando usa primeiramente Get-CsHostingProvider para retornar uma coleção de todos os provedores de hospedagem em uso. A coleção filtrada será então canalizada para Remove-CsHostingProvider, que excluirá cada item na coleção. Quando este comando terminar, não haverá mais nenhum provedor de hospedagem configurado para uso.

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

Get-CsHostingProvider -Filter "*Fabrikam*" | Remove-CsHostingProvider

O comando anterior excluirá quaisquer provedores de hospedagem nos quais o valor da cadeia de caracteres "Fabrikam" constar em algum lugar na identidade provedor. Para realizar esta tarefa, o comando chama primeiramente Get-CsHostingProvider e o parâmetro Filter; o valor de filtro "*Fabrikam*" limita os dados retornados a quaisquer provedores de hospedagem que tiverem "Fabrikam" em algum lugar na identidade. Por exemplo, este comando poderia retornar provedores como Fabrikam.com, Fabrikam.net e FabrikamUsers.com. Esta coleção filtrada é então canalizada para Remove-CsHostingProvider, que exclui cada item na coleção.

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

Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"} | Remove-CsHostingProvider

No Exemplo 4, serão excluídos todos os provedores de hospedagem nos quais o nível de verificação estiver definido como algo diferente de AlwaysVerifiable. Isto é feito chamando-se primeiramente Get-CsHostingProvider sem quaisquer parâmetros adicionais; este comando retornará uma coleção de todos os provedores de hospedagem configurados para uso na organização. A coleção restante será canalizada para o cmdlet Where-Object, que selecionará apenas os provedores em que a propriedade VerificationLevel for igual a AlwaysVerifiable. A coleção filtrada é então passada a Remove-CsHostingProvider, que remove cada provedor nesta coleção.

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

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

O comando anterior remove todos os provedores de hospedagem que estiverem desabilitados. Para fazer isso, o comando usa primeiramente Get-CsHostingProvider para retornar uma coleção de todos os provedores de hospedagem configurados para uso na organização. Esta coleção é canalizada para Where-Object, que seleciona apenas os provedores que estiverem desabilitados; isto é, apenas os provedores nos quais a propriedade Enabled for igual a False. A coleção filtrada é canalizada para Remove-CsHostingProvider que exclui cada um dos provedores de hospedagem desabilitados.