Compartilhar via

  • Artigo

Get-CsBlockedDomain

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os domínios incluídos na lista de domínios bloqueados para federação. Por definição, seus usuários não estão autorizados a usar aplicativos do Microsoft Lync Server 2010 para se comunicar com pessoas de um domínio bloqueado; por exemplo, os usuários não podem usar o Microsoft Lync 2010 para trocar mensagens instantâneas com qualquer pessoa que tenha uma conta de protocolo SIP em um domínio na lista de bloqueios.

Sintaxe

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

Get-CsBlockedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

A federação é uma forma na qual duas organizações podem estabelecer um relacionamento 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 enviar outras mensagens instantâneas, assinar notificações de presença e se comunicar entre si usando 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 terceiro.

Configurar a federação direta com outra organização envolve várias tarefas. Para começar, é preciso configurar o serviço Borda de Acesso de Servidor Lync para permitir a federação. Além disso, a outra organização precisa habilitar a federação com você; a federação não pode ser estabelecida a menos que ambas as partes concordem com o relacionamento.

Para configurar uma relação federada, também pode ser necessário 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 aparece na lista de permissões, então (dependendo das suas configurações) seus usuários vão poder trocar mensagens instantâneas e informação de presença com usuários que possuam contas nesse domínio federado. Por outro lado, a lista de bloqueados representa domínios com os quais os usuários estão expressamente proibidos de estabelecer federação; por exemplo, mensagens enviadas de um domínio bloqueado serão automaticamente rejeitadas pelo Lync Server 2010.

O cmdlet Get-CsBlockedDomain permite retornar informações sobre os domínios que aparecem na lista de domínios bloqueados.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsBlockedDomain localmente: RTCUniversalUserAdmins, 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 "Get-CsBlockedDomain"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Nome do domínio a ser retornado. Os domínios são relacionados na lista de bloqueios pelo FQDN (nome de domínio totalmente qualificado); assim, o parâmetro Identity de um determinado domínio será semelhante a fabrikam.com ou contoso.net. Observe que não é possível usar curingas durante a especificação de uma Identidade de domínio. Para usar curingas e retornar um determinado domínio (ou um conjunto de domínios), use o parâmetro Filter em seu lugar.

Se esse parâmetro não for especificado, todos os domínios na lista de domínios bloqueados serão retornados.

Filter

Opcional

Cadeia de caracteres

Permite que você use caracteres curinga para retornar um ou mais domínios da lista de domínios bloqueados. Para retornar todos os domínios que tenham uma Identidade que comece com a letra "r", use esta sintaxe: -Filter r*. Para retornar todos os domínios que tenham uma Identidade que termine com ".net", use esta sintaxe: -Filter "*.net". Para retornar todos os domínios que possuem uma identidade começando pela letra "f" ou pela letra "g", use esta sintaxe: -Filter [fg]*.

LocalStore

Opcional

Parâmetro de opção

Obtém os dados de domínios bloqueados a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsBlockedDomain não aceita entrada em pipeline.

Tipos de Retorno

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

Exemplo

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

Get-CsBlockedDomain

O comando mostrado no Exemplo 1 retorna uma coleção de todos os domínios incluídos na lista de domínios bloqueados. Isso é feito chamando-se Get-CsBlockedDomain sem parâmetros adicionais.

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

Get-CsBlockedDomain -Identity fabrikam.com

No Exemplo 2, o único domínio bloqueado retornado é o que possui identidade igual a "fabrikam.com". Uma vez que os domínios na lista de bloqueios precisam ter identidades exclusivas, esse comando retornará, no máximo, um único item.

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

Get-CsBlockedDomain -Filter *.net

O Exemplo 3 usa o parâmetro Filter para retornar uma coleção de todos os domínios bloqueados que possuem identidade terminando com a cadeia de caracteres ".net". Esse comando de exemplo retorna domínios como northwindtraders.net, contoso.net e fabrikam.net.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null}

O comando anterior retorna uma coleção de todos os domínios cuja propriedade Comment não possui valor. Para fazer isso, o comando usa primeiro Get-CsBlockedDomain para retornar uma coleção de todos os domínios da lista de bloqueios. Essa coleção é então canalizada para o cmdlet Where-Object, que seleciona somente os domínios cuja propriedade Comment seja igual a um valor nulo.

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

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

No Exemplo 5, todos os domínios bloqueados que incluem uma cadeia de caracteres igual a "Ken Myer" em qualquer posição da propriedade Comment serão retornados. Para realizar essa tarefa, o método Get-CsBlockedDomain é chamado em primeiro lugar para retornar uma coleção de todos os domínios da lista de domínios bloqueados. A coleção é então canalizada para o Where-Object, que seleciona aqueles domínios cuja propriedade Comment contenha a cadeia de caracteres "Ken Myer".