Compartilhar via

  • Artigo

New-CsBlockedDomain

 

Tópico modificado em: 2012-03-23

Adiciona um novo domínio à lista de domínios bloqueados para federação. Por definição, os seus usuários não podem utilizar aplicativos do Microsoft Lync Server 2010 para se comunicar com pessoas do domínio bloqueado. Por exemplo: os usuários não podem utilizar o Microsoft Lync 2010 para trocar mensagens instantâneas com pessoas com uma conta SIP em um domínio que conste da lista de bloqueios.

Sintaxe

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

New-CsBlockedDomain -Domain <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 Lync 2010. O 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 estabelecer 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 você escolheu se federar; se um domínio constar da lista de permissões, então, dependendo de suas definições de configuração, 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 New-CsBlockedDomain permite adicionar um domínio à lista de domínios bloqueados.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsBlockedDomain localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsBlockedDomain"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Cadeia de caracteres

Nome do domínio totalmente qualificado (FQDN) do domínio a ser adicionado à lista de bloqueios. Por exemplo: "fabrikam.com". É possível usar o parâmetro Identity ou Domain (mas não ambos) para especificar o nome do domínio. Se você usar Identity, a propriedade Domain será definida com o mesmo valor atribuído a Identity. Se você usar Domain, a propriedade Identity será definida com o mesmo valor atribuído a Domain.

Observe que as identidades devem ser exclusivas: se o domínio especificado já existir na lista de bloqueios ou de permissões, o comando falhará.

Comment

Opcional

Cadeia de caracteres

O valor da cadeia de caracteres opcional fornece informações adicionais sobre o domínio bloqueado. Por exemplo, é possível adicionar um Comentário que explique porque o domínio foi bloqueado.

Domain

Opcional

Cadeia de caracteres

FQDN (por exemplo: fabrikam.com) do domínio a ser adicionado à lista de bloqueios. É possível usar o parâmetro Identity ou Domain (mas não ambos) para especificar o nome do domínio. Se você usar Identity, a propriedade Domain será definida com o mesmo valor atribuído a Identity. Se você usar Domain, a propriedade Identity será definida com o mesmo valor atribuído a Domain.

Observe que os Domínios devem ser exclusivos: se o domínio especificado já existir na lista de bloqueios ou de permissões, o comando falhará.

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.

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma. New-CsBlockedDomain não aceita a entrada canalizada.

Tipos de Retorno

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

Exemplo

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

New-CsBlockedDomain -Identity "fabrikam.com" -Comment "Blocked per Ken Myer."

No exemplo anterior, o domínio fabrikam.com é adicionado à lista de domínios bloqueados. Para realizar isso, chama-se New-CsBlockedDomain, juntamente com o parâmetro Identity, ao qual será atribuído o nome do domínio a ser bloqueado. Além disso, inclui-se o parâmetro Comment, para adicionar um comentário ao domínio bloqueado. Observe que esse comando falhará se fabrikam.com já estiver na lista de bloqueios ou na lista de permissões.

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

$x = New-CsBlockedDomain -Identity "fabrikam.com" -InMemory
$x.Comment = "Blocked per Ken Myer."
Set-CsBlockedDomain -Instance $x

O Exemplo 2 mostra como é possível usar o parâmetro InMemory para criar um novo domínio bloqueado, que inicialmente existirá apenas na memória. Depois de modificar os valores da propriedade desse domínio que está apenas na memória, chame Set-CsBlockedDomain, para adicioná-lo à lista de bloqueios.

Para realizar essa tarefa, a primeira linha no comando usa New-CsBlockedDomain e o parâmetro InMemory, para criar um domínio bloqueado com a Identidade fabrikam.com. Ao ser criado, esse domínio virtual será armazenado na variável $x.

Na segunda linha, a propriedade Comment do domínio virtual é modificada. Depois disso, a linha 3 usará o cmdlet Set-CsBlockedDomain para adicionar o domínio virtual à lista de bloqueios. Sem a linha 3, o domínio virtual existiria apenas na memória e nunca seria adicionado à lista de bloqueios. Em vez disso, o domínio virtual desaparecerá assim que você encerrar a sessão do Windows PowerShell ou excluir a variável $x.