Compartilhar via

  • Artigo

Set-CsBlockedDomain

 

Tópico modificado em: 2012-03-26

Modifica a propriedade Comment de um ou mais dos 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 Microsoft Lync Server 2010 para se comunicar com pessoas da lista de domínio bloqueado; por exemplo, usuários não podem empregar Microsoft Lync 2010 para trocar mensagens instantâneas com ninguém com uma conta SIP em um domínio que aparece na lista bloqueada.

Sintaxe

Set-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsBlockedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

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 fornecedor público; e 3 ) federação entre sua organização e um provedor de hospedagem de terceiros.

Instalar 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 precisa habilitar federação com você; 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 autorizada e a lista bloqueada. A lista autorizada representa as organizações que você escolheu para federar; se um domínio aparece na lista autorizada, 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 têm contas neste 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.

A propriedade Comment, a única de um domínio bloqueado que pode ser modificada, é usada para armazenar informações adicionais sobre um domínio na lista de bloqueados (por exemplo, por que o domínio está sendo bloqueado; quando o domínio pode ser removido da lista de bloqueados; quem contatar para que o domínio seja removido da lista de bloqueados). Se for preciso precisar alterar a propriedade Comment de qualquer domínio na lista de domínios bloqueados, use o cmdlet Set-CsBlockedDomain.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Cadeia de caracteres

FQDN (nome de domínio totalmente qualificado) do domínio bloqueado para o qual a propriedade Comment está sendo modificada. Por exemplo: fabrikam.com

Instance

Opcional

Objeto BlockedDomain

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

Permite o fornecimento de informações adicionais sobre o domínio que está sendo modificado. Por exemplo, você pode adicionar um Comment que indica porque o domínio foi colocado na lista bloqueada.

Force

Opcional

Parâmetro de Opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na 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.BlockedDomain. Set-CsBlockedDomain aceita instâncias em pipeline do objeto de domínio bloqueado.

Tipos de Retorno

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

Exemplo

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

Set-CsBlockedDomain -Identity fabrikam.com -Comment "Block this domain pending legal review."

O comando mostrado no Exemplo 1 modifica o Comment para o domínio bloqueado com a Identity "fabrikam.com". Neste exemplo, o parâmetro Comment é incluído junto com o valor do parâmetro "Block this domain pending legal review".

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

Get-CsBlockedDomain | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

No exemplo anterior, a propriedade Comment é atualizada para todos os domínios incluídos na lista de domínios bloqueados. Para fazer isto, o comando primeiro chama Get-CsBlockedDomain, que retorna uma coleção de todos os domínios atualmente na lista de domínios bloqueados. Esta coleção é então direcionada para Set-CsBlockedDomain, que modifica a propriedade Comment para cada domínio na coleção.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

No exemplo 3, um novo comentário ("Block this domain pending legal review.") é adicionado a cada domínio na lista de bloqueados que ainda não tenha um valor configurado pra a propriedade Comment. Para fazer isto, o comando primeiro usa Get-CsBlockedDomain para retornar uma coleção de todos os domínios atualmente na lista de bloqueados. Esta coleção é então direcionada para o cmdlet Where-Object, que seleciona somente aqueles domínios nos quais a propriedade Comment seja igual a um valor nulo. A coleção filtrada é então direcionada para Set-CsBlockedDomain, que atribui o mesmo comentário à propriedade Comment de cada domínio na coleção filtrada.