Compartilhar via

  • Artigo

Get-CsTrustedApplicationComputer

 

Tópico modificado em: 2012-03-23

Recupera informações sobre um ou mais computadores que hospedam aplicativos confiáveis.

Sintaxe

Get-CsTrustedApplicationComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]

Get-CsTrustedApplicationComputer [-Filter <String>] [-Pool <String>]

Descrição Detalhada

Recomendamos que os computadores que estiverem executando aplicativos 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. Utilize esse cmdlet para recuperar a identidade (FQDN) e o pool no qual está localizado um ou mais computadores que contenham aplicativos confiáveis.

É possível utilizar esse cmdlet para recuperar computadores com base no FQDN do computador ou para recuperar todos os computadores que fizerem parte de um pool especificado.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O nome de domínio totalmente qualificado (FQDN) do computador que se deseja recuperar.

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que inclui caracteres curinga, que permite recuperar computadores confiáveis com base nos valores de identidade que coincidirem com esta cadeia de caracteres curinga.

Pool

Opcional

Cadeia de caracteres

O FQDN do pool de aplicativos confiáveis sobre o qual se deseja recuperar informações do computador.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

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

Exemplo

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

Get-CsTrustedApplicationComputer

O Exemplo 1 recupera todos os computadores que tiverem sido atribuídos a qualquer pool de aplicativos confiáveis na implantação do Lync Server 2010.

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

Get-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com

O Exemplo 2 recupera informações sobre o computador com o FQDN Trust1.litwareinc.com.

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

Get-CsTrustedApplicationComputer -Filter Trust*

Este exemplo utiliza o parâmetro Filter para realizar uma pesquisa de caracteres curinga de todos os computadores que tiverem o FQDN iniciado pela cadeia de caracteres Trust e que tiverem sido atribuídos a pools de aplicativos confiáveis. O parâmetro Filter pesquisa a propriedade Identity de todos os computadores de aplicativos confiáveis. O caractere curinga (*) no final da cadeia de caracteres indica que Filter deve procurar identidades que comecem com a cadeia de caracteres Trust, seguida de quaisquer outros caracteres.

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

Get-CsTrustedApplicationComputer -Pool TrustPool.litwareinc.com

O Exemplo 4 recupera uma lista de todos os computadores que tiverem sido atribuídos ao pool de aplicativos confiáveis TrustPool.litwareinc.com.

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

Get-CsTrustedApplicationComputer | Where-Object {$_.Pool -like "*.litwareinc.com"}

No Exemplo 3, usamos o parâmetro Filter para realizar uma pesquisa de caracteres curinga com base na identidade (o FQDN do computador). Neste exemplo, estamos fazendo novamente uma pesquisa de caracteres curinga, mas desta vez com base no pool, em vez da identidade. Chamamos primeiramente Get-CsTrustedApplicationComputer, para recuperar uma coleção de todos os computadores contendo aplicativos confiáveis. Essa coleção será canalizada para o cmdlet Where-Object. Where-Object permite restringir a coleção que foi canalizada até ele. Neste caso, desejamos manter apenas os computadores contendo aplicativos confiáveis que estiverem em qualquer pool do domínio litwareinc.com. Para fazer isso, verificamos a propriedade Pool de cada item na coleção ($_.Pool), testando a sua coincidência (-like) com a cadeia de caracteres curinga *.litwareinc.com. Haverá coincidência do valor com a cadeia de caracteres se ele começar com qualquer conjunto de caracteres e terminar com a cadeia de caracteres .litwareinc.com.