Partager via

  • Article

Set-CsTrustedApplication

 

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

Modifie les paramètres d’une application approuvée.

Syntaxe

Set-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Port <Int32>] [-WhatIf [<SwitchParameter>]]

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 modifier le numéro de port que le service externe qui exécute l’application utilise.

Lorsque vous utilisez cette cmdlet pour modifier une application approuvée, vous devez fournir une valeur pour le paramètre Identity. Le paramètre Identity est composé du nom de domaine complet du pool sur lequel l’application est hébergée, suivi d’une barre oblique (/), puis de l’ID d’application. Par exemple, TrustPool.litwareinc.com/tapp2, où TrustPool.litwareinc.com est le nom de domaine complet du pool et tapp2 est l’ID d’application. Notez que si vous affichez une application existante en appelant Get-CsTrustedApplication, vous verrez un ID ressemblant plutôt à celui-ci : TrustPool.litwareinc.com/urn:application:tapp2. Remarquez le préfixe urn:application: avant le nom de l’application (tapp2). Bien que ce préfixe fasse partie de l’identité, il n’est pas requis lorsque vous spécifiez la valeur pour le 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 Set-CsTrustedApplication : 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 –matches "Set-CsTrustedApplication\b"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

ExternalApplicationIdentity

Identificateur unique de l’application approuvée à modifier. 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.

Port

Facultatif

Int32

Numéro de port sur lequel l’application sera exécutée.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.Xds.DisplayTrustedApplication. Accepte la saisie de données transmises via le pipeline pour les objets des applications approuvées.

Types de retours

Cette cmdlet ne renvoie aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Exemple

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

Set-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6200

Cet exemple remplace le port de l’application approuvée avec le paramètre Identity TrustPool.litwareinc.com/tapp2 par le port 6200. Pour cela, la cmdlet Set-CsTrustedApplication reçoit un paramètre Identity TrustPool.litwareinc.com/tapp2. Ce paramètre Identity comprend le nom du pool dans lequel l’application réside, suivi du nom (ou ID) de l’application. Nous incluons ensuite le paramètre Port, en lui donnant la valeur 6200.