Get-CsTrustedApplicationComputer
Dernière rubrique modifiée : 2012-03-23
Récupère des informations sur un ou plusieurs ordinateurs qui hébergent des applications approuvées.
Syntaxe
Get-CsTrustedApplicationComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]
Get-CsTrustedApplicationComputer [-Filter <String>] [-Pool <String>]
Description détaillée
Il est recommandé d’ajouter les ordinateurs exécutant les applications approuvées au sein d’un déploiement Microsoft Lync Server 2010 à un pool distinct, dédié à ces applications approuvées. Toutefois, vous pouvez ajouter les ordinateurs hébergeant les applications approuvées à un pool existant utilisé à d’autres fins. Utilisez cette cmdlet pour récupérer le paramètre Identity (nom de domaine complet) et le pool sur lequel se trouvent un ou plusieurs ordinateurs contenant les applications approuvées.
Vous pouvez utiliser cette cmdlet pour récupérer les ordinateurs d’après le nom de domaine complet ou récupérer tous les ordinateurs faisant partie d’un pool précis.
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-CsTrustedApplicationComputer : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les 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-CsTrustedApplicationComputer"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsGlobalRelativeIdentity |
Nom de domaine complet de l’ordinateur à récupérer. |
Filter |
Facultatif |
Chaîne |
Chaîne qui inclut des caractères génériques et vous permet de récupérer des ordinateurs approuvés en fonction des valeurs Identity qui correspondent à la chaîne à caractères génériques donnée. |
Pool |
Facultatif |
Chaîne |
Nom de domaine complet du pool d’applications approuvées dont vous voulez récupérer les informations d’ordinateurs. |
Types d’entrées
Aucun.
Types de retours
Récupère un ou plusieurs objets de type Microsoft.Rtc.Management.Xds.DisplayComputer.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsTrustedApplicationComputer
L’exemple 1 récupère tous les ordinateurs qui ont été attribués à un pool d’applications approuvées au sein du déploiement Lync Server 2010.
-------------------------- Exemple 2 ------------------------
Get-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com
L’exemple 2 récupère des informations sur l’ordinateur dont le nom de domaine complet est Trust1.litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsTrustedApplicationComputer -Filter Trust*
Cet exemple utilise le paramètre Filter pour effectuer une recherche par caractères génériques de tous les ordinateurs dont le nom de domaine complet commence par la chaîne Trust et qui ont été attribués à des pools d’applications approuvées. Le paramètre Filter recherche la propriété Identity de tous les ordinateurs d’applications approuvées. Le caractère générique (*) à la fin de la chaîne signifie que Filter doit rechercher les identités commençant par la chaîne Trust, suivie d’autres caractères.
-------------------------- Exemple 4 ------------------------
Get-CsTrustedApplicationComputer -Pool TrustPool.litwareinc.com
L’exemple 4 récupère une liste de tous les ordinateurs qui ont été attribués au pool d’applications approuvées TrustPool.litwareinc.com.
-------------------------- Exemple 5 ------------------------
Get-CsTrustedApplicationComputer | Where-Object {$_.Pool -like "*.litwareinc.com"}
Dans l’exemple 3, nous avons utilisé le paramètre Filter pour effectuer une recherche par caractères génériques sur la propriété Identity (nom de domaine complet de l’ordinateur). Dans cet exemple, nous effectuons à nouveau une recherche par caractères génériques, mais sur le pool cette fois, et non sur l’identité. Nous appelons tout d’abord Get-CsTrustedApplicationComputer pour récupérer une collection de tous les ordinateurs d’applications approuvées. Cette collection est ensuite redirigée vers la cmdlet Where-Object. Where-Object nous permet de réduire la collection que nous lui envoyons. Dans ce cas, nous souhaitons conserver uniquement les ordinateurs d’applications approuvées qui se trouvent dans les pools du domaine litwareinc.com. Pour cela, nous vérifions la propriété Pool de chaque élément de la collection ($_.Pool) afin de voir si sa valeur correspond (-like) à la chaîne à caractères génériques *.litwareinc.com. Une valeur correspondra à cette chaîne si elle commence par un ensemble quelconque de caractères et se termine par .litwareinc.com.