Disable-CsHostingProvider

Sintaxe

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

Disable-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. Além disso, é possível usar o cmdlet Disable-CsHostingProvider para desabilitar a relação, a qualquer momento. Quando você desabilita um provedor de hospedagem, ele permanece um parceiro de federação válido; no entanto, toda atividade de comunicação entre a organização e o provedor será suspensa até que o provedor seja reabilitado.

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

Parâmetros

Tipos de Entrada

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

Tipos de Retorno

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

Exemplo

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

Disable-CsHostingProvider -Identity "Fabrikam.com"

O comando mostrado no Exemplo 1 desabilita o provedor de hospedagem Fabrikam.com. Observe que esse comando retornará uma mensagem de erro se Fabrikam.com já estiver desabilitado.

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

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

O comando anterior desabilita todos os provedores de hospedagem habilitados no momento. Para isso, o comando chama inicialmente Get-CsHostingProvider para retornar uma coleção de todos os provedores de hospedagem configurados para uso na organização. Essa coleção é então redirecionada para o cmdlet Where-Object, que separa apenas os provedores nos quais a propriedade Enabled seja igual a True. Em seguida, a coleção filtrada é redirecionada para Disable-CsHostingProvider, que desabilita cada provedor da coleção.

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

Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsHostingProvider

No Exemplo 3, todos os provedores de hospedagem habilitados nos quais o nível de verificação não seja igual a AlwaysVerifiable são desabilitados. Para realizar essa tarefa, o comando usa inicialmente Get-CsHostingProvider para retornar uma coleção de todos os provedores de hospedagem configurados para uso na organização. Essa coleção é redirecionada para o cmdlet Where-Object, que só seleciona os provedores que atendam a dois critérios: 1) a propriedade VerificationLevel não seja igual a AlwaysVerifiable e 2) a propriedade Enabled seja igual a True. Em seguida, a coleção filtrada é redirecionada para Disable-CsHostingProvider, que desabilita cada provedor da coleção.

Consulte Também

Outros Recursos

Enable-CsHostingProvider
Get-CsHostingProvider
New-CsHostingProvider
Remove-CsHostingProvider
Set-CsHostingProvider