Compartilhar via

  • Artigo

Get-CsTrustedApplicationPool

 

Tópico modificado em: 2012-03-23

Recupera definições de um ou mais pools que contêm os computadores que hospedam aplicativos confiáveis.

Sintaxe

Get-CsTrustedApplicationPool [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]

Get-CsTrustedApplicationPool [-Filter <String>] [-PoolFqdn <String>]

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. Esse cmdlet recupera um ou vários pools que tiverem sido definidos como pools de aplicativos confiáveis.

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

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O nome de domínio totalmente qualificado (FQDN) ou ID de serviço do pool cujas definições se deseja recuperar.

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que contém um ou vários caracteres curinga, utilizada para procurar um pool com uma Identidade correspondente à cadeia de caracteres curinga. Por exemplo: ao se especificar a cadeia de caracteres *Redmond*, serão recuperados todos os pools de aplicativos confiáveis cujas identidades contiverem a cadeia de caracteres Redmond, como TrustedApplicationPool:Redmond.litwareinc.com.

PoolFqdn

Opcional

Cadeia de caracteres

O FQDN do pool que se deseja recuperar. Ele se comporta da mesma maneira que o parâmetro Identity, exceto pelo fato de que Identity também aceita um ID de serviço.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Recupera um ou mais objetos do tipo Microsoft.Rtc.Management.Xds.DisplayExternalServer.

Exemplo

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

Get-CsTrustedApplicationPool

O Exemplo 1 recupera todos os pools na implantação do Lync Server 2010 que tiverem sido definidos como pools de aplicativos confiáveis.

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

Get-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com

Nesse exemplo, utilizamos o parâmetro Identity, para garantir que recuperaremos apenas um pool de aplicativo confiável. Mais especificamente, o pool com o FQDN TrustPool.litwareinc.com.

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

Get-CsTrustedApplicationPool -Filter *:TrustPool.*

Esse exemplo recupera todos os pools de aplicativos confiáveis que contiverem o site TrustPool no FQDN do pool. O parâmetro Filter é utilizado com o valor *:TrustPool.*. Essa cadeia de caracteres de filtro buscará os valores de Identidade de todos os pools de aplicativos confiáveis que contiverem a cadeia de caracteres “:TrustPool.”. Por exemplo: esse comando irá recuperar o pool com o valor de Identidade TrustedApplicationPool:TrustPool.litwareinc.com.

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

Get-CsTrustedApplicationPool | Where-Object {$_.ServiceId -like "Redmond1*"}

O parâmetro Filter pesquisará apenas a Identidade, que, no caso dos pools de aplicativos confiáveis, é o ID do serviço, no formato TrustedApplicationPool:<FQDN>. Esse exemplo pesquisa pools com base no ID do serviço, no formato <site>-ExternalServer-<id>. Por exemplo: Redmond1-ExternalServer-1. Isso permite encontrar pools confiáveis hospedados em um site específico. O exemplo inicialmente chama Get-CsTrustedApplicationPool sem parâmetros, que recupera uma coleção de todos os pools de aplicativos confiáveis. Essa coleção será então canalizada para o cmdlet Where-Object, que restringirá a coleção apenas aos pools nos quais o ID de serviço ($_.ServiceId) corresponder à cadeia de caracteres curinga (-like) Redmond1*. O resultado será uma coleção de todos os pools de aplicativos confiáveis com FQDNs que começarem com a cadeia de caracteres Redmond1, como Redmond1-ExternalServer-1, Redmond1-ExternalServer-2 e Redmond1-ExternalServer-3.