New-CsTrustedApplication
Dernière rubrique modifiée : 2012-03-26
Ajoute une application approuvée à un pool.
Syntaxe
New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]
New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-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 ajoute une application approuvée à un pool d’applications approuvées et affecte un port au service externe exécutant l’application.
Les applications approuvées doivent être associées à des GRUU (Globally Routable User Agent URI), qu’il s’agisse de GRUU de service ou d’ordinateur. Cette cmdlet génère automatiquement ces valeurs en fonction des ordinateurs et des services associés au pool sur lequel cette application est hébergée.
Lorsque vous utilisez cette cmdlet pour créer une application approuvée, vous devez saisir des valeurs pour le paramètre Identity ou pour les paramètres ApplicationID et TrustedApplicationPoolFqdn. L’identité est le le paramètre TrustedApplicationPoolFqdn, suivi d’une barre oblique (/) et de l’ID d’application. Par exemple : TrustPool.litwareinc.com/tapp2, où TrustPool.litwareinc.com correspond à TrustedApplicationPoolFqdn et tapp2 à ApplicationID.
Notez que lorsque vous saisissez un ID d’application (soit dans le paramètre Identity, soit dans le paramètre ApplicationID), seul le nom de l’application est obligatoire. Cependant, l’ID d’application complet sera automatiquement précédé de la chaîne urn:application:. Par exemple, si vous attribuez la valeur tapp2 au paramètre ApplicationID, cet ID sera stocké au format urn:application:tapp2. De même, si vous saisissez l’identité TrustPool.litwareinc.com/tapp2, elle sera stockée dans le système au format TrustPool.litwareinc.com/urn:application:tapp2.
Lorsque vous spécifiez la valeur Port avec cette cmdlet, elle n’ouvre pas le port. Vous devez ouvrir le port dans le pare-feu Windows et tous les pare-feu de l’organisation pour que l’application approuvée puisse entrer en contact avec les réseaux en dehors du pare-feu.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 –match "New-CsTrustedApplication\b"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
ExternalApplicationIdentity |
Identificateur unique de l’application approuvée sur le pool. Les valeurs du paramètre Identity doivent être saisies au format <nom de domaine complet du pool>/<ID d’application>, où « nom de domaine complet du pool » correspond au nom de domaine complet du pool sur lequel réside l’application et « ID d’application » au nom de l’application. L’ID de l’application doit être unique à un pool donné. Si vous saisissez une identité, vous ne pouvez pas spécifier de valeurs pour les paramètres ApplicationId ou TrustedApplicationPoolFqdn. |
ApplicationId |
Obligatoire |
Chaîne |
Nom de l’application. Ce dernier doit être une chaîne unique au sein du pool qui est spécifié dans le paramètre TrustedApplicationPoolFqdn. La chaîne ne doit contenir aucun espace. Si vous entrez une valeur pour ApplicationId, vous devez également attribuer une valeur au paramètre TrustedApplicationPoolFqdn. Vous ne pouvez pas spécifier les paramètres ApplicationId et Identity. |
Port |
Obligatoire |
Int32 |
Numéro de port sur lequel l’application sera exécutée. Le port doit être unique au sein d’un pool donné. En d’autres termes, aucune autre application utilisant ce même port ne peut être définie sur le pool spécifié. |
TrustedApplicationPoolFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet du pool d’applications approuvées sur lequel l’application doit résider. Si vous saisissez une valeur pour TrustedApplicationPoolFqdn, vous devez également attribuer une valeur au paramètre ApplicationId. Toutefois, aucune valeur ne peut être saisie pour le paramètre Identity. |
EnableTcp |
Facultatif |
Paramètre de commutateur |
Indique que l’application approuvée utilisera le protocole TCP (Transmission Control Protocol). N’utilisez ce paramètre que si l’application approuvée n’est pas une application Microsoft Unified Communications Managed API (UCMA). En effet, les applications UCMA prennent uniquement en charge le protocole MTLS (Mutual Transport Layer Security). Si vous ne spécifiez pas le paramètre Force avec le paramètre EnableTcp, une invite de confirmation s’affichera avant la création de la nouvelle application approuvée. |
LegacyApplicationName |
Facultatif |
Chaîne |
N’utilisez ce paramètre que si la migration de l’application s’effectue à partir d’un déploiement Microsoft Office Communications Server 2007 R2. Cette valeur doit être identique au type GRUU de la version Office Communications Server 2007 R2 de l’application pour que les deux fonctionnent ensemble. Notez que dans la plupart des cas, la définition d’un paramètre ApplicationId égal au type GRUU est suffisante pour permettre le fonctionnement des applications ensemble. Toutefois, si le type GRUU de l’application Office Communications Server 2007 R2 contient des caractères qui ne sont pas valides dans un ApplicationId, cette valeur doit être fournie dans le paramètre LegacyApplicationName. Si vous ne spécifiez aucune valeur pour ce paramètre, la valeur de l’ID d’application sera automatiquement insérée (sans le préfixe urn:application:). |
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
Aucun.
Types de retours
Crée un objet de type Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.
Exemple
-------------------------- Exemple 1 ------------------------
New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000
Cet exemple illustre la création d’une application approuvée avec l’ID d’application tapp1. Nous utilisons le paramètre TrustedApplicationPoolFqdn pour désigner le pool d’applications approuvées sur lequel cette application sera exécutée, ici, le pool doté du nom de domaine complet TrustPool.litwareinc.com. Nous devons par ailleurs spécifier un port pour l’application. Dans cet exemple, nous avons utilisé le port 6000. Notez que l’exécution de cette cmdlet en spécifiant les paramètres ApplicationId et TrustedApplicationPoolFqdn entraînera automatiquement la génération d’une identité que vous pourrez utiliser pour extraire, modifier ou supprimer cette application.
-------------------------- Exemple 2 ------------------------
New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100
Dans cet exemple, nous créons une applications approuvée comportant l’identité TrustPool.litwareinc.com/tapp2 sur le port 6100. Observez le format de l’identité. Cette valeur doit être au format <Nom de domaine complet du pool approuvé>/<ID d’application>.
Voir aussi
Autres ressources
Remove-CsTrustedApplication
Set-CsTrustedApplication
Get-CsTrustedApplication