Get-CsAllowedDomain

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

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.

Consulte Também

Outros Recursos

New-CsAllowedDomain
Remove-CsAllowedDomain
Set-CsAccessEdgeConfiguration
Set-CsAllowedDomain