Compartilhar via

  • Artigo

Get-CsAllowedDomain

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os domínios incluídos na lista de domínios aprovados para federação. Depois que um domínio for aprovado para federação (sendo adicionado à lista de permissões), os usuários poderão trocar mensagens instantâneas e informações de presença com pessoas que tenham contas nesse domínio.

Sintaxe

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

Get-CsAllowedDomain [-Filter <String>] [-LocalStore <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 enviar mensagens instantâneas entre si, assinar notificações de presença e 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.

A configuração de uma federação direta com outra organização envolve várias tarefas. Para começar, você deve habilitar os servidores de Borda de Acesso 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 ambas as partes concordem com a relação.

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 (necessária se EnablePartnerDiscovery tiver sido desabilitada) representa as organizações com as quais você escolheu federar. Se um domínio aparecer na lista de permissões (dependendo das definições de configuração), seus usuários poderão trocar mensagens instantâneas e informações de presença com usuários que tenham 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-CsAllowedDomain oferece uma forma de retornar informações sobre todos os domínios na lista de domínios permitidos.

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

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 permissões 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 permitidos serão retornados.

Filter

Opcional

Cadeia de caracteres

Permite usar caracteres curinga para retornar um ou mais domínios da lista de domínios permitidos. 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 tenham uma Identidade que comece com a letra "r" ou com a letra "g", use esta sintaxe: -Filter [rg]*.

LocalStore

Opcional

Parâmetros de opção

Obtém os domínios permitidos 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-CsAllowedDomain não aceita entrada em pipeline.

Tipos de Retorno

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

Exemplo

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

Get-CsAllowedDomain

O comando anterior retorna uma coleção de todos os domínios incluídos na lista de domínios aprovados para federação. A chamada de Get-CsAllowedDomain, sem nenhum parâmetro adicional, sempre retornará a coleção completa de domínios aprovados.

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

Get-CsAllowedDomain -Identity fabrikam.com

O Exemplo 2 retorna informações sobre o domínio permitido com a Identidade "fabrikam.com". Como as identidades devem ser únicas, o comando jamais retornará mais de um item.

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

Get-CsAllowedDomain -Filter *fabrikam*

O comando mostrado no Exemplo 3 retorna uma coleção de todos os domínios permitidos que tenham o valor da cadeia de caracteres "fabrikam" em qualquer lugar da Identidade. Para fazer isso, o comando usa o parâmetro Filter e o valor de filtro "*fabrikam*". Esse valor de filtro pede a Get-CsAllowedDomain que retorne apenas os domínios nos quais a Identidade (a única propriedade pela qual é possível filtrar) inclua o valor de cadeia de caracteres "fabrikam". Domínios como fabrikam.com, fabrikam.net e africa.fabrikam.org serão todos retornados por esse comando.

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

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

No Exemplo 4, os cmdlets Get-CsAllowedDomain e Where-Object são usados para retornar uma coleção de todos os domínios nos quais nenhum valor foi inserido para a propriedade ProxyFqdn. Para realizar essa tarefa, Get-CsAllowedDomain é chamado inicialmente sem nenhum parâmetro adicional para retornar uma coleção de todos os domínios permitidos. Em seguida, essa coleção é redirecionada para Where-Object, que seleciona apenas os domínios permitidos nos quais a propriedade ProxyFqdn seja igual a um valor nulo; um valor nulo significa que nenhum valor foi inserido para ProxyFqdn. Para localizar todos os domínios que tenham algum tipo de valor configurado para a propriedade ProxyFqdn, use esta sintaxe em seu lugar:

Where-Object {$_.ProxyFqdn -ne $Null}

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

Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $True}

O comando anterior retorna todos os domínios permitidos que tenham seu status de integridade verificado pelo Servidor de Monitoramento. Para isso, Get-CsAllowedDomain é usado inicialmente para retornar uma coleção de todos os domínios na lista de domínios permitidos. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa apenas os domínios nos quais a propriedade MarkForMonitoring seja igual a True.