Compartilhar via

  • Artigo

Remove-CsTrustedApplicationComputer

 

Tópico modificado em: 2012-03-26

Remove um computador de aplicativos confiáveis.

Sintaxe

Remove-CsTrustedApplicationComputer -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

É recomendável que os computadores que estiverem executando aplicativos confiáveis em uma implantação do Microsoft Lync Server 2010 sejam adicionados a um outro pool, destinado apenas a aplicativos confiáveis. No entanto, é possível adicionar computadores de aplicativos confiáveis a um pool existente que também é usado para outros fins. Use esse cmdlet para remover um computador de aplicativos confiáveis.

Ao se usar esse cmdlet para remover um computador de aplicativos confiáveis, ele será removido não somente da lista de computadores de aplicativos confiáveis, mas também da lista de computadores disponíveis no Lync Server 2010. Em outras palavras, se você chamar Get-CsTrustedApplicationComputer ou Get-CsComputer, o computador deixará de ser listado. Não é possível remover um computador de aplicativos confiáveis se ele for o único computador no pool. Se desejar remover o único computador em um pool, será necessário remover todo o pool (o que pode ser feito chamando-se Remove-CsTrustedApplicationPool).

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

O nome de domínio totalmente qualificado do computador a ser removido.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.Xds.DisplayComputer. Aceita entrada canalizada dos objetos de computador de aplicativos confiáveis.

Tipos de Retorno

Este cmdlet não retorna um valor. Remove um objeto do tipo Microsoft.Rtc.Management.Xds.DisplayComputer.

Exemplo

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

Remove-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com

Esse exemplo remove o computador com o FQDN Trust1.litwareinc.com.

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

Get-CsTrustedApplicationComputer -Filter Trust* | Remove-CsTrustedApplicationComputer

Esse exemplo remove todos os computadores confiáveis que possuírem FQDNs iniciados pela cadeia de caracteres Trust. O exemplo inicialmente chama o cmdlet Get-CsTrustedApplicationComputer, passando o valor Trust* ao parâmetro Filter. Isso irá recuperar todos os computadores de aplicativos confiáveis cujo FQDN começar com Trust e terminar com qualquer conjunto de caracteres. Essa coleção de computadores será então canalizada para o cmdlet Remove-CsTrustedApplicationComputer, que removerá cada item (computador) na coleção. Lembre-se de que isso não removerá os computadores de um pool, se isso resultar em um pool vazio.