Compartilhar via

  • Artigo

Set-CsAllowedDomain

 

Tópico modificado em: 2012-03-27

Modifica os valores de propriedade de um domínio (ou domínios) incluído na lista de domínios aprovados para federação. Depois que um domínio tiver sido 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 possuírem contas no domínio federado.

Sintaxe

Set-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Set-CsAllowedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-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 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.

O cmdlet Set-CsAllowedDomain permite modificar os valores de propriedades de qualquer domínio da lista de domínios permitidos.

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

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 permitido, cujos valores de propriedade estiverem sendo modificados. Por exemplo:

-Identity fabrikam.com

Instance

Opcional

Objeto de domínio bloqueado

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

Comment

Opcional

Cadeia de caracteres

Valor da cadeia de caracteres opcional que fornece informações adicionais sobre o domínio que estiver sendo modificado. Por exemplo, é possível adicionar um comentário que forneça informações de contato do domínio federado.

MarkForMonitoring

Opcional

Booleano

Indica se a conexão de federação entre o seu domínio e o domínio remoto será monitorada pelo Servidor de Monitoramento. Por padrão, MarkForMonitoring é definido como False, indicando que a conexão não será monitorada.

Essa propriedade será ignorada se o Servidor de Monitoramento não tiver sido implantado.

ProxyFqdn

Opcional

Fqdn

O nome de domínio totalmente qualificado (proxy-server.fabrikam.com, por exemplo) do servidor proxy SIP implantado no domínio a ser adicionado à lista de permissões. Essa propriedade é opcional: se não for especificada, os procedimentos de descoberta de SRV DNS serão usados para determinar a localização do servidor proxy SIP.

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

Tipos de Retorno

Set-CsAllowedDomain não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Exemplo

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

Set-CsAllowedDomain -Identity fabrikam.com -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"

O comando exibido no Exemplo 1 modifica a propriedade Comment do domínio permitido cuja Identidade for "fabrikam.com". Isso é feito incluindo-se o parâmetro Comment e o valor de parâmetro relevante: "Contact: Ken Myer (kenmyer@fabrikam.com)".

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

Get-CsAllowedDomain -Filter *fabrikam* | Set-CsAllowedDomain -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)" -MarkForMonitoring $True

O comando anterior modifica as propriedades Comment e MarkForMonitoring de todos os domínios permitidos que possuírem o valor de cadeia de caracteres "fabrikam" em alguma posição de Identidade. Para realizar essa tarefa, o comando primeiramente chama Get-CsAllowedDomain, juntamente com o parâmetro Filter. O valor de filtro "*fabrikam*" instrui Get-CsAllowedDomain a retornar qualquer domínio cuja Identidade incluir o valor de cadeia de caracteres "fabrikam". (por exemplo, esse comando retornará domínios como fabrikam.com, us.fabrikam.net e fabrikam-users.org). A coleção filtrada será então canalizada para Set-CsAllowedDomain, que modificará a propriedade Comment e definirá a propriedade MarkForMonitoring de cada item na coleção como True ($True).

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

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

O comando exibido no Exemplo 3 modifica todos os domínios na lista de permissões que não estiverem sendo monitorados pelo Servidor de Monitoramento (ou seja, todos os domínios cuja propriedade MarkForMonitoring estiver definida como False). Para fazer isso, Get-CsAllowedDomain é chamado, sem qualquer parâmetro adicional, para recuperar uma coleção de todos os domínios na lista de permissões. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os domínios nos quais MarkForMonitoring for igual a False. Esta coleção filtrada será canalizada para Set-CsAllowedDomain, que definirá a propriedade MarkForMonitoring de cada domínio da coleção como True.

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

Get-CsAllowedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsAllowedDomain -Comment "Need contact information."

O Exemplo 4 adiciona um comentário genérico ("Informações de contato necessárias") a cada domínio da lista de permissões cuja propriedade Comment não tiver valor. Para realizar essa tarefa, o comando primeiramente chama Get-CsAllowedDomain, para recuperar uma coleção de todos os domínios na lista de permissões. Essa coleção será então canalizada para Where-Object, que selecionará apenas os domínios cuja propriedade Comment for igual a um valor nulo. Essa coleção filtrada será então canalizada para Set-CsAllowedDomain, que modificará a propriedade Comment de cada item da coleção.