Partager via

  • Article

Get-CsTrustedApplicationPool

 

Dernière rubrique modifiée : 2012-03-23

Récupère les paramètres d’un ou de plusieurs pools contenant les ordinateurs qui hébergent les applications approuvées.

Syntaxe

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

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

Description détaillée

Nous vous recommandons d’ajouter les ordinateurs exécutant les applications approuvées dans le cadre d’un déploiement Microsoft Lync Server 2010 à un pool distinct et exclusivement consacré à ces applications approuvées. Toutefois, vous pouvez ajouter les ordinateurs hébergeant les applications approuvées à un pool existant utilisé à d’autres fins. Cette cmdlet récupère un ou plusieurs pools qui ont été définis en tant que pools d’applications approuvées.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsTrustedApplicationPool : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste des rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

Nom de domaine complet (FQDN) ou ID de service du pool dont vous souhaitez récupérer les paramètres.

Filter

Facultatif

Chaîne

Chaîne contenant un ou plusieurs caractères génériques utilisés pour rechercher un pool dont l’identité (Identity) correspond à la chaîne à caractères génériques. Par exemple, si vous spécifiez la chaîne *Redmond*, tous les pools d’applications approuvées dont les identités contiennent la chaîne Redmond sont retournés (par exemple : TrustedApplicationPool:Redmond.litwareinc.com).

PoolFqdn

Facultatif

Chaîne

Nom de domaine complet du pool que vous souhaitez récupérer. Le comportement de ce paramètre est le même que celui du paramètre Identity, sauf que le paramètre Identity accepte également un ID de service.

Types d’entrées

Aucun.

Types de retours

Récupère un ou plusieurs objets de type Microsoft.Rtc.Management.Xds.DisplayExternalServer.

Exemple

-------------------------- Exemple 1 ------------------------

Get-CsTrustedApplicationPool

L’exemple 1 récupère tous les pools dans le déploiement Lync Server 2010 qui ont été définis comme pools d’applications approuvées.

-------------------------- Exemple 2 ------------------------

Get-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com

Dans cet exemple, le paramètre Identity est utilisé de manière à ne récupérer qu’un seul pool d’applications approuvées, soit le pool dont le nom de domaine complet est TrustPool.litwareinc.com.

-------------------------- Exemple 3 ------------------------

Get-CsTrustedApplicationPool -Filter *:TrustPool.*

Cet exemple récupère tous les pools d’applications approuvées contenant le site TrustPool dans le nom de domaine complet du pool. Le paramètre Filter est utilisé avec la valeur *:TrustPool.*. Cette chaîne de filtre recherche tous les pools d’applications approuvées dont la valeur Identity contient la chaîne « :TrustPool. ». Par exemple, cette commande extrait le pool dont la valeur Identity est TrustedApplicationPool:TrustPool.litwareinc.com.

-------------------------- Exemple 4 ------------------------

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

Le paramètre Filter recherche uniquement l’identité qui, dans le cas des pools d’applications approuvées, correspond à l’ID de service au format TrustedApplicationPool:<FQDN>. Cet exemple recherche des pools d’après un ID de service au format <site>-ExternalServer-<id> (par exemple, Redmond1-ExternalServer-1). Il est donc possible de rechercher des pools approuvés hébergés sur un site spécifique. Pour commencer, l’exemple appelle la cmdlet Get-CsTrustedApplicationPool sans aucun paramètre afin de récupérer une collection de tous les pools d’applications approuvées. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui la restreint aux pools dont l’ID de service ($_.ServiceId) correspond à la chaîne à caractères génériques (-like) Redmond1*. Ainsi donc, tous les pools d’applications approuvées dont le nom de domaine complet commence par la chaîne Redmond1 (comme Redmond1-ExternalServer-1, Redmond1-ExternalServer-2 et Redmond1-ExternalServer-3) sont collectés.