Partilhar via

  • Artigo

Remove-CsTrustedApplicationPool

 

Tópico modificado em: 2012-03-25

Remove um pool que contém os computadores que hospedam aplicativos confiáveis.

Sintaxe

Remove-CsTrustedApplicationPool -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 pool separado, 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. Este cmdlet remove um pool existente de aplicativos confiáveis. Entretanto, não é possível remover um pool de aplicativos confiáveis que não tiver um valor Registrador. Se não tiver sido atribuído um Registrador ao pool de aplicativos confiáveis, deve-se adicionar um valor de Registrador com o cmdlet Set-CsTrustedApplicationPool e, em seguida, remover o pool.

Lembre-se de que remover o pool também remove todos os computadores, aplicativos e pontos de extremidades de aplicaitvos associados a esse pool.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

O nome de domínio totalmente qualificado (FQDN) ou ID de serviço do pool que se deseja remover.

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.DisplayExternalServer. Aceita entrada em pipeline dos objetos de pool de aplicativos confiáveis.

Tipos de Retorno

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

Exemplo

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

Remove-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com

Este exemplo remove o pool cujo FQDN for TrustPool.litwareinc.com. O parâmetro Identity é utilizado para especificar o FQDN do pool que se deseja remover. Como essas identidades são exclusivas, este comando removerá, no máximo, um pool.

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

Get-CsTrustedApplicationPool | Where-Object {$_.PoolFqdn -match "trust*"} | Remove-CsTrustedApplicationPool

Este exemplo remove todos os pools confiáveis nos quais o FQDN do pool começar com a cadeia de caracteres "trust". A primeira parte do comando é uma chamada para o cmdlet Get-CsTrustedApplicationPool, que recupera uma coleção de todos os pools de aplicativos confiáveis na infraestrutura do Lync Server 2010. Esta coleção será canalizada para o cmdlet Where-Object. O cmdlet Where-Object verifica cada item na coleção para testar se PoolFqdn coincide com a cadeia de caracteres curinga trust*. Isto resultará em uma coleção de pools de aplicativos confiáveis nos quais o PoolFqdn começa com a cadeia de caracteres trust, seguida de qualquer caractere ou caracteres. Finalmente, esta coleção filtrada será canalizada para o cmdlet Remove-CsTrustedApplicationPool, que removerá cada item na coleção.