Partilhar via

  • Artigo

Remove-CsTrustedApplication

 

Tópico modificado em: 2012-03-26

Remove um aplicativo confiável do serviço confiável associado.

Sintaxe

Remove-CsTrustedApplication -Identity <ExternalApplicationIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Um aplicativo confiável é um aplicativo desenvolvido por um terceiro que recebeu o status de confiável para ser executado como parte do Microsoft Lync Server 2010, embora não seja uma parte interna do produto. Esse cmdlet remove um aplicativo confiável de um pool de aplicativos confiáveis. Observe que o aplicativo propriamente dito não é excluído. Apenas a associação com o pool de aplicativos confiável e com o serviço confiável é removida.

Ao usar esse cmdlet para remover um aplicativo confiável, você deve fornecer um valor para o parâmetro Identity. Identity é o nome de domínio totalmente qualificado (FQDN) do pool no qual está hospedado o aplicativo seguido de uma barra (/) e do ID do aplicativo. Por exemplo, TrustPool.litwareinc.com/tapp2, em que TrustPool.litwareinc.com é o FQDN do pool e tapp2 é o ID do aplicativo. Observe que, se exibir um aplicativo existente chamando Get-CsTrustedApplication, você verá um ID semelhante a este: TrustPool.litwareinc.com/urn:application:tapp2. Observe o prefixo urn:application: antes do nome do aplicativo (tapp2). Embora faça parte da Identity, esse prefixo não é obrigatório quando você especifica o valor do parâmetro Identity.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

ExternalApplicationIdentity

O identificador exclusivo do aplicativo confiável a ser removido do pool de aplicativos confiável. Os valores de identidade devem ser digitados no formato <FQDN do pool>/<ID do aplicativo>, onde FQDN do pool é o FQDN do pool no qual o aplicativo reside, e ID do aplicativo é o nome do aplicativo.

Force

Opcional

SwitchParameter

Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

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

Tipos de Retorno

Este cmdlet não retorna um valor. Ele remove um objeto do tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Exemplo

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

Remove-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2

Este exemplo remove o aplicativo confiável com a Identidade TrustPool.litwareinc.com/tapp2 do serviço confiável associado.

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

Get-CsTrustedApplication -Filter *trust* | Remove-CsTrustedApplication

O Exemplo 2 remove todos os aplicativos confiáveis que tenham identidades que incluam a cadeia de caracteres “trust”. O comando começa com uma chamada para Get-CsTrustedApplication, passando um valor Filter de *trust*. Esse comando recuperará todos os aplicativos confiáveis com a cadeia de caracteres trust em qualquer lugar da Identidade. Em seguida, a coleção de aplicativos confiáveis recuperada é redirecionada para o cmdlet Remove-CsTrustedApplication, que remove cada um como um aplicativo confiável. (Observe que o aplicativo propriamente dito. Apenas a associação com o pool de aplicativos confiável e com o serviço confiável é removida.)