• Artigo

Remove-CsBlockedDomain

 

Tópico modificado em: 2012-03-27

Remove um domínio da lista de domínios bloqueados para federação. Por definição, os seus usuários não podem utilizar aplicativos Microsoft Lync Server 2010 para se comunicar com pessoas do domínio bloqueado. Por exemplo: os usuários não podem utilizar o Microsoft Lync 2010 para trocar mensagens instantâneas com pessoas que tiverem uma conta SIP em um domínio que conste da lista de bloqueios.

Sintaxe

Remove-CsBlockedDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A federação é um meio pelo qual duas organizações podem definir um relacionamento de confiança que facilita a comunicação entre os dois grupos. 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 Lync Server 2010 permite três tipos de federação: 1) federação direta entre sua organização e 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.

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 estabelecer 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 você escolheu se federar; se um domínio constar da lista de permissões, então, dependendo de suas definições de configuração, 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 bloqueados 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.

Obviamente, as mensagens serão rejeitadas apenas enquanto o domínio constar da lista de bloqueios; depois que o domínio for removido da lista, será possível estabelecer um relacionamento federado com ele. Para habilitar a federação com um domínio previamente proibido, é necessário utilizar o cmdlet Remove-CsBlockedDomain, para remover esse domínio da lista de domínios bloqueados. Um domínio não pode aparecer simultaneamente nas listas de bloqueios e permitidos

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Cadeia de caracteres

Nome de domínio totalmente qualificado (FQDN) do domínio a ser removido da lista de bloqueios (fabrikam.com, por exemplo). Observe que não é possível utilizar caracteres curinga ao especificar uma identidade de domínio.

Force

Opcional

Parâmetros 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â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.BlockedDomain. Remove-CsBlockedDomain aceita instâncias canalizadas do objeto de domínio bloqueado.

Tipos de Retorno

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

Exemplo

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

Remove-CsBlockedDomain -Identity fabrikam.com

O comando exibido no Exemplo 1 remove o domínio fabrikam.com da lista de domínios bloqueados. Isso é realizado chamando-se Remove-CsBlockedDomain e especificando-se o domínio com a Identidade "fabrikam.com".

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

Get-CsBlockedDomain -Filter *fabrikam* | Remove-CsBlockedDomain

No Exemplo 2, todos os domínios que possuírem uma identidade que inclui o valor de cadeia de caracteres "fabrikam" serão removidos da lista de domínios bloqueados. Para realizar isso, primeiramente são usados Get-CsBlockedDomain e o parâmetro Filter, para retornar uma coleção de todos os domínios bloqueados que incluírem a cadeia de caracteres "fabrikam" em qualquer lugar de sua Identidade (por exemplo, fabrikam.com, fabrikam.org, ou us.fabrikam.net). Essa coleção será então canalizada para Remove-CsBlockedDomain, que excluirá cada item na coleção da lista de domínios bloqueados.

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

Get-CsBlockedDomain | Remove-CsBlockedDomain

O comando exibido no Exemplo 3 limpa completamente a lista de domínios bloqueados. Efetua-se essa tarefa chamando-se primeiramente Get-CsBlockedDomain sem parâmetros, resultando em uma coleção retornada que consiste em todos os domínios que estiverem na lista de domínios bloqueados. Essa coleção será então canalizada para Remove-CsBlockedDomain, que removerá cada item na coleção da lista de domínios bloqueados. O resultado: nenhum domínio será deixado na lista de domínios bloqueados.