Partager via

  • Article

Get-CsTrustedApplication

 

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

Récupère les paramètres d’une application approuvée.

Syntaxe

Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]

Get-CsTrustedApplication [-Filter <String>]

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

Description détaillée

Une application approuvée est une application développée par un tiers et qui est approuvée pour s’exécuter dans Microsoft Lync Server 2010, mais qui ne fait pas partie intégrante du produit. Cette cmdlet vous permet de récupérer les paramètres de port et de GRUU (Globally Routable User Agent URI) pour une ou plusieurs applications approuvées.

Lorsque vous utilisez cette cmdlet pour récupérer une seule application approuvée, vous devez fournir une valeur pour le paramètre Identity. L’identité est le nom de domaine complet (FQDN) du pool sur lequel l’application réside suivi d’une barre oblique (/) suivie de l’ID de l’application. Par exemple, TrustPool.litwareinc.com/tapp2, où TrustPool.litwareinc.com est le nom de domaine complet du pool et tapp2 est l’ID de l’application. Notez que lorsque vous récupérez une application en appelant cette cmdlet, vous voyez un ID qui ressemble davantage à ceci : TrustPool.litwareinc.com/urn:application:tapp2. Notez l’ajout du préfixe urn:application: avant le nom de l’application (tapp2). Si ce préfixe est intégré à l’identité, il n’est pas nécessaire lorsque vous spécifiez la valeur du paramètre Identity.

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-CsTrustedApplication : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsTrustedApplication\b"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

ExternalApplicationIdentity

Identificateur unique de l’application approuvée que vous souhaitez récupérer. Les valeurs Identity doivent être saisies au format <nom de domaine complet du pool>/<ID de l’application>, où « nom de domaine complet du pool » désigne le nom de domaine complet du pool dans lequel l’application réside, et « ID de l’application » le nom de l’application. Notez que si vous spécifiez une identité, vous ne pouvez pas spécifier un ApplicationID ou un TrustedApplicationPoolFqdn.

Filter

Facultatif

Chaîne

Chaîne contenant des caractères génériques et permettant de récupérer des applications approuvées en fonction des valeurs Identity qui correspondent à la chaîne à caractères génériques donnée. Les identités sont composées d’un nom de domaine complet d’un pool d’applications approuvées suivi d’une barre oblique (/) suivie de l’ID de l’application approuvée. La valeur du paramètre Filter correspondra à n'importe quelle partie de l’identité, au nom de domaine complet et à l’ID d’application.

ApplicationId

Facultatif

Chaîne

Nom de l’application. Vous pouvez inclure le préfixe de l’ID d’application mais cela n’est pas une obligation. Par exemple, les valeurs ApplicationId pour urn:application:tapp1 et tapp1 retourneront la même application. Si vous spécifiez une valeur pour ApplicationId, vous ne pouvez pas fournir une valeur pour l’identité mais vous devez fournir une valeur pour le paramètre TrustedApplicationPoolFqdn.

TrustedApplicationPoolFqdn

Facultatif

Chaîne

Nom de domaine complet du pool d’applications approuvées dans lequel l’application résidera. Si vous spécifiez une valeur pour TrustedApplicationPoolFqdn, vous ne pouvez pas fournir une valeur pour l’identité mais vous devez fournir une valeur pour le paramètre ApplicationID.

Types d’entrées

Aucun.

Types de retours

Retourne un objet de type Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Exemple

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

Get-CsTrustedApplication

Cet exemple récupère des informations sur les applications approuvées définies dans le déploiement Lync Server 2010.

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

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

L’exemple 2 récupère l’application approuvée dont l’identité est TrustPool.litwareinc.com/urn:application:tapp2. Notez que nous avons pu omettre le préfixe urn:application:. La cmdlet Get-CsTrustedApplication ajoute le préfixe automatiquement et récupère l’application correcte.

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

Get-CsTrustedApplication -Filter *trust*

L’exemple 3 récupère toutes les applications approuvées dont les identités correspondent à la chaîne à caractères génériques spécifiée comme valeur du paramètre Filter. Dans ce cas, avec une valeur *trust* définie pour le paramètre Filter, la commande récupèrera toutes les applications approuvées contenant la chaîne « trust » dans leur identité. Cette chaîne peut apparaître dans n’importe quelle partie de l’identité, le nom de domaine complet du pool ou l’ID de l’application. Ainsi donc, cette commande récupèrera les applications approuvées avec des identités telles que TrustedPool.litwareinc.com/urn:application:application1, Pool1.litwareinc.com/urn:application:trustedapp et Pool1.litwareinc.com/urn:application:trust.

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

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

L’exemple 4 retournera les mêmes résultats que l’exemple 2 (où l’identité était le seul paramètre spécifié). La seule différence entre les deux exemples est que l’exemple 2 récupère l’application approuvée en fonction de l’identité qui se compose du nom de domaine complet du pool d’applications approuvées suivi de l’ID de l’application. Dans cet exemple, l’ID de l’application et le nom de domaine complet du pool sont saisis sous la forme de valeurs pour deux paramètres distincts : ApplicationId et TrustedApplicationPoolFqdn.

-------------------------- Exemple 5 ------------------------

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

L’exemple 5 récupère toutes les applications approuvées du pool TrustPool.litwareinc.com. L’exemple commence par appeler la cmdlet Get-CsTrustedApplication. Il en résulte le retour d’une collection de tous les applications approuvées définies au sein du déploiement Lync Server. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui examine la collection élément par élément pour trouver ceux dont la valeur de la propriété TrustedApplicationPoolFqdn est égale à (-eq) TrustPool.litwareinc.com.