Compartilhar via

  • Artigo

Get-CsTrustedApplication

 

Tópico modificado em: 2012-03-23

Recupera as definições de um aplicativo confiável.

Sintaxe

Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]

Get-CsTrustedApplication [-Filter <String>]

Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]

Descrição Detalhada

Um aplicativo confiável é um aplicativo desenvolvido por terceiros que recebe um determinado status para ser executado como parte do Microsoft Lync Server 2010, mas que não é uma parte integrante do produto. Esse cmdlet permite recuperar a porta e as definições de URIs de operador usuário de encaminhamento global (GRUU) correspondentes a um ou mais aplicativos confiáveis.

Quando se usa esse cmdlet para recuperar um único aplicativo confiável, será necessário fornecer o valor do parâmetro Identity. A Identidade é o nome de domínio totalmente qualificado (FQDN) do pool no qual está hospedado o aplicativo, seguido de uma barra invertida (/) e do ID do aplicativo. Por exemplo, TrustPool.litwareinc.com/tapp2, onde TrustPool.litwareinc.com é o FQDN do pool e tapp2 é o ID do aplicativo. Observe que, quando se recupera um aplicativo chamando esse cmdlet, é possível ver um ID cuja aparêcia se assemelha mais ao seguinte: TrustPool.litwareinc.com/urn:application:tapp2. Observe o prefixo urn:application: antes do nome do aplicativo (tapp2). Embora esse prefixo faça parte da Identidade, ele não será necessário ao se especificar o valor do parâmetro Identity.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsTrustedApplication localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplication\b"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

ExternalApplicationIdentity

O identificador exclusivo do aplicativo confiável que deseja recuperar. Os valores de Identidade devem ser inseridos no formato <FQDN do pool>/<ID do aplicativo>, onde FQDN é o nome do domínio totalmente qualificado do pool no qual reside o aplicativo e ID do aplicativo é o nome do aplicativo. Observe que se for especificada uma Identidade, não será possível especificar um ApplicationID ou um TrustedApplicationPoolFqdn.

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que inclui caracteres curinga, que permite recuperar aplicativos confiáveis com base nos valores de identidade que coincidirem com esta cadeia de caracteres curinga. As identidades consistem em um FQDN do pool do aplicativo confiável seguido de uma barra invertida (/) e do IS do aplicativo confiável. O valor de Filtro corresponderá a qualquer parte da Identidade, o FQDN ou o ID do aplicativo.

ApplicationId

Opcional

Cadeia de caracteres

O nome do aplicativo. Isso pode incluir o prefixo de ID do aplicativo, mas não é obrigatório. Por exemplo: os valores de ApplicationId de urn:application:tapp1 e tapp1 retornarão o mesmo aplicativo. Caso se forneça um valor para ApplicationId, não será possível fornecer um valor para a Identidade, mas será necessário fornecer um valor para o parâmetro TrustedApplicationPoolFqdn.

TrustedApplicationPoolFqdn

Opcional

Cadeia de caracteres

O FQDN do pool do aplicativo confiável no qual residirá o aplicativo. Caso se forneça um valor para TrustedApplicationPoolFqdn, não será possível fornecer um valor para a Identidade, mas será necessário fornecer um valor para o parâmetro ApplicationID.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Retorna um objeto do tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Exemplo

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

Get-CsTrustedApplication

Este exemplo recupera informações sobre todos os aplicativos confiáveis definidos na implantação do Lync Server 2010.

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

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

O Exemplo 2 recupera o aplicativo confiável com a Identidade TrustPool.litwareinc.com/urn:application:tapp2. Observe que foi possível omitir o prefixo urn:application: Get-CsTrustedApplication adiciona o prefixo automaticamente e recupera o aplicativo correto.

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

Get-CsTrustedApplication -Filter *trust*

O Exemplo 3 recupera todos os aplicativos confiáveis que possuírem identidades que correspondem à cadeia de caracteres curinga especificada como o valor de Filter. Nesse caso, com o valor de Filter *trust*, o comando irá recuperar todos os aplicativos confiáveis que contiverem a cadeia de caracteres “trust” em qualquer posição da Identidade. Essa cadeia de caracteres pode estar compreendida em qualquer parte da Identidade, do FQDN do pool ou do ID do aplicativo. Portanto, esse comando irá recuperar aplicativos confiáveis com identidades como TrustedPool.litwareinc.com/urn:application:application1, Pool1.litwareinc.com/urn:application:trustedapp e Pool1.litwareinc.com/urn:application:trust.

-------------------------- Exemplo 4 ------------------------

Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

O Exemplo 4 retornará os mesmos resultados que o Exemplo 2 (no qual a Identidade foi especificada como único parâmetro). A única diferença entre os dois exemplos é que o Exemplo 2 recupera o aplicativo confiável com base na Identidade, que consiste no FQDN do pool confiável seguido do ID do aplicativo. Nesse exemplo, o ID do aplicativo e o FQDN do pool confiável são inseridos como valores de dois parâmetros diferentes: ApplicationId e TrustedApplicationPoolFqdn.

-------------------------- Exemplo 5 ------------------------

Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}

O Exemplo 5 recupera todos os aplicativos confiáveis no pool TrustPool.litwareinc.com. Inicialmente, o exemplo chama o cmdlet Get-CsTrustedApplication. Isto recuperará uma coleção de todos os aplicativos confiáveis definidos na implantação do Lync Server. Essa coleção será então canalizada para o cmdlet Where-Object, que pesquisará cada item de toda a coleção, para localizar os itens cujo valor de propriedade TrustedApplicationPoolFqdn for igual a (-eq) TrustPool.litwareinc.com.