Compartilhar via

  • Artigo

Remove-CsAllowedDomain

 

Tópico modificado em: 2012-03-26

Remove um domínio da lista de domínios aprovados para federação.

Sintaxe

Remove-CsAllowedDomain -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 Microsoft 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.

A definição de uma federação direta com outra organização envolve diversas tarefas. Para começar, é necessário habilitar os servidores que executam o serviço de Borda de acesso do Lync Server, para permitir a federação. Além disso, a outra organização deve habilitar a federação com você; a federação não pode ser estabelecida a menos que as duas partes concordem com o relacionamento.

Para configurar um relacionamento federado, é necessário também gerenciar duas listas relacionadas à federação: a lista de permissões e a lista de bloqueios. A lista de permissões representa as organizações com as quais se escolheu estabelecer a federação. Se um domínio constar da lista de permissões, então, dependendo de suas definições de configuração, os seus usuários poderão trocar mensagens instantâneas e informações de presença com usuários que possuírem contas nesse domínio federado. Por outro lado, a lista de bloqueios representa os domínios com os quais os usuários não podem se federar. Por exemplo: as mensagens enviadas de um domínio bloqueado serão automaticamente rejeitadas pelo Lync Server 2010.

Caso queira interromper o relacionamento de federação, use o cmdlet Remove-CsAllowedDomain, para remover o domínio apropriado da lista de domínios permitidos e em seguida, se for pertinente, use New-CsBlockedDomain para adicioná-lo à lista de domínios bloqueados. Observe que um domínio não pode aparecer nas listas de bloqueios e permissões ao mesmo tempo.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Cadeia de caracteres

Nome do domínio totalmente qualificado (FQDN) do domínio a ser removido da lista de permissões (fabrikam.com, por exemplo). Não é possível utilizar caracteres curinga ao se especificar uma identidade de domínio.

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.AllowedDomain. Remove-CsAllowedDomain aceita instâncias canalizadas do objeto de domínio permitido.

Tipos de Retorno

Exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Exemplo

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

Remove-CsAllowedDomain -Identity fabrikam.com

O comando exibido no Exemplo 1 remove o domínio fabrikam.com da lista de domínios permitidos.

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

Get-CsAllowedDomain -Filter *fabrikam* | Remove-CsAllowedDomain

No Exemplo 2, todos os domínios que possuírem um valor de cadeia de caracteres "fabrikam" em alguma posição de sua Identidade serão removidos da lista de domínios permitidos. Para fazer isso, o comando primeiramente usa Get-CsAllowedDomain e o parâmetro Filter, para retornar uma coleção de domínios que possuírem o valor de cadeia de caracteres "fabrikam" em alguma posição de sua Identidade (a única propriedade que pode ser filtrada). Essa coleção filtrada será então canalizada para Remove-CsAllowedDomain, que, por sua vez, removerá todos os itens na coleção filtrada da lista de domínios permitidos.

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

Get-CsAllowedDomain | Where-Object {$_.ProxyFqdn -eq $Null} | Remove-CsAllowedDomain

O Exemplo 3 remove todos os domínios que não apresentarem um servidor de proxy identificado da lista de domínios permitidos. Para realizar essa tarefa, chama-se Get-CsAllowedDomain, para retornar uma coleção de todos os domínios que estiverem na lista de permissões. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os domínios cuja propriedade ProxyFqdn for igual a um valor nulo. A coleção filtrada será então canalizada para Remove-CsAllowedDomain, que removerá cada domínio na coleção da lista de permissões.

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

Get-CsAllowedDomain | Where-Object {$_.Comment -match "Ken Myer"} | Remove-CsAllowedDomain

No exemplo anterior, todos os domínios cujo campo Comment contiver o valor da cadeia de caracteres "Ken Myer" serão removidos da lista de domínios permitidos. Para realizar essa tarefa, o comando primeiramente usa Get-CsAllowedDomain, para recuperar uma coleção de todos os domínios na lista de domínios permitidos. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os domínios cuja propriedade Comment contiver o valor de cadeia de caracteres "Ken Myer". Essa coleção filtrada será então canalizada para Remove-CsAllowedDomain, que removerá cada item na coleção da lista de domínios permitidos.