Partager via

  • Article

New-CsTrustedApplicationPool

 

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

Crée un pool qui contiendra les ordinateurs qui hébergent les applications approuvées.

Syntaxe

New-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-Registrar <String>] [-RequiresReplication <$true | $false>] [-Site <String>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]

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. Si le pool existe déjà dans la topologie, cette cmdlet crée le service externe associé à ce pool (avec un rôle de service ExternalServer). Si le pool n’existe pas, cette cmdlet le crée, avec le service correspondant. (Vous trouverez une liste de tous les pools existants en appelant la cmdlet Get-CsPool.)

La création d’un pool d’applications approuvées (nouveau service externe) entraîne également la création d’un ordinateur d’applications approuvées attribué à ce pool. Par défaut, l’ordinateur sera attribué au même nom de domaine complet que le pool. Toutefois, vous pouvez spécifier votre propre valeur pour le nom de domaine complet en utilisant le paramètre ComputerFqdn de cette cmdlet. Si vous prévoyez d’ajouter des ordinateurs au pool, vous devez spécifier une valeur ComputerFqdn différente du nom de domaine complet du pool. Pour ajouter d’autres ordinateurs au pool, appelez la cmdlet New-CsTrustedApplicationComputer.

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-CsTrustedApplicationPool : 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-CsTrustedApplicationPool"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Nom de domaine complet du nouveau pool. Notez que bien que la valeur Identity pour la création d’un pool soit le nom de domaine complet du pool, la valeur qui sera stockée comme propriété Identity avec le nouveau pool est en fait un ID de service du pool, généré de façon automatique. La valeur Identity entrée ici sera enregistrée en tant que PoolFqdn.

AppSharingPortCount

Facultatif

Uint16

Nombre de ports de la plage de ports disponibles pour les connexions de partage d’applications.

Valeur par défaut : 0

AppSharingPortStart

Facultatif

UInt16

Numéro du premier port de la plage de ports disponible pour les connexions de partage d’applications.

AudioPortCount

Facultatif

UInt16

Nombre de ports de la plage de ports disponibles pour les connexions audio.

Valeur par défaut : 0

AudioPortStart

Facultatif

UInt16

Numéro du premier port de la plage de ports disponible pour les connexions audio.

ComputerFqdn

Facultatif

FQDN

La création d’un pool d’applications approuvées créera automatiquement un ordinateur d’applications approuvées faisant partie de ce pool. Par défaut, l’ordinateur recevra le même nom de domaine complet que le pool. Entrez une valeur dans ce paramètre pour spécifier un nom de domaine complet pour l’ordinateur, différent du nom de domaine complet du pool. Si vous prévoyez d’ajouter des ordinateurs au pool, vous devez entrer une valeur pour ce paramètre, différente du nom de domaine complet du pool.

OutboundOnly

Facultatif

Booléen

Spécifie si une application approuvée peut initialiser une connexion à un serveur du pool. Définissez cette valeur sur True si vous souhaitez que toutes les connexions soient initialisées par le serveur plutôt que par l’application.

Valeur par défaut : False

Registrar

Facultatif

Chaîne

ID de service ou nom de domaine complet du service Serveur d’inscriptions pour le pool.

Notez que bien que ce paramètre soit facultatif, si vous essayez de créer un point de terminaison d’applications approuvées (à l’aide de la cmdlet New-CsTrustedApplicationEndpoint) et de l’attribuer à un pool sans dépendance au Serveur d’inscriptions, une erreur s’affiche et le point de terminaison n'est pas créé. De plus, vous ne pouvez pas supprimer un pool d’applications approuvées qui n’est pas associé à un serveur d’inscriptions.

RequiresReplication

Facultatif

Booléen

Détermine si la réplication est requise pour ce pool. Définissez cette valeur sur False si la réplication n’est pas requise. Vous devriez généralement définir ce paramètre sur False pour Microsoft Outlook Web Access et les applications configurées manuellement.

Valeur par défaut : True

Site

Facultatif

Chaîne

ID du site sur lequel ce pool est hébergé. Appelez la cmdlet Get-CsSite pour récupérer la propriété SiteId d’un site. Gardez à l’esprit que vous devez utiliser la propriété SiteId plutôt que l’identité du site. Notez également que vous ne devez pas faire précéder SiteId de la chaîne « site: ». Vous ne devez en effet saisir que la propriété SiteId. En outre, bien que vous saisissiez la propriété SiteId récupérée de Get-CsSite, la propriété SiteId du nouveau pool d’applications approuvées ne contiendra que l’identité Site. Par exemple, si la propriété SiteId du site est Main et que l’identité du site est site:Redmond1, vous devez saisir -Site Main dans votre appel de New-CsTrustedApplicationPool, mais l’appel suivant Get-CsTrustedApplicationPool indique la propriété SiteId comme étant site:Redmond1.

Si le pool spécifié dans la propriété Identity existe déjà, vous n’avez pas à spécifier la propriété Site. Si le pool n’existe pas, ce paramètre est requis.

ThrottleAsServer

Facultatif

Booléen

Définissez ce paramètre sur False pour limiter les connexions entre les serveurs du pool et les applications approuvées (ou clients). Cette valeur False restreint davantage les connexions que la valeur True par défaut, qui limite les connexions en tant que serveurs. Le fait de limiter une connexion restreint le nombre de transactions pouvant avoir lieu simultanément.

Valeur par défaut : True

TreatAsAuthenticated

Facultatif

Booléen

Détermine si l’authentification est requise pour les applications approuvées se connectant aux serveurs du pool. Définissez ce paramètre sur False si vous souhaitez que les applications approuvées soient authentifiées. La valeur True par défaut permet aux applications approuvées de se connecter en partant du principe qu’elles ont déjà été authentifiées.

Valeur par défaut : True

VideoPortCount

Facultatif

UInt16

Nombre de ports de la plage de ports disponibles pour les connexions vidéo.

Valeur par défaut : 0

VideoPortStart

Facultatif

Uint16

Numéro du premier port de la plage de ports disponible pour les connexions vidéo.

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.DisplayExternalServer.

Exemple

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

New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond

Cet exemple crée un pool avec le nom de domaine complet TrustPool.litwareinc.com. Nous utilisons le paramètre Identity pour spécifier le nouveau nom de domaine complet. Nous utilisons le paramètre Registrar avec la valeur pool0.litwareinc.com pour associer le nouveau pool au service Serveur d’inscriptions pour ce nom de domaine complet. Enfin, nous utilisons le paramètre Site avec la valeur Redmond pour spécifier que ce pool fera partie du site Redmond.

Notez que la valeur Site est la propriété SiteId (pouvant être récupérée par l’appel de Get-CsSite). Toutefois, l’identité Site sera stockée avec le nouveau pool d’applications approuvées. Ainsi, si un site porte l’identité site:Redmond1 et contient la propriété SiteId NA, vous devez utiliser NA comme valeur du paramètre Site dans votre appel de New-CsTrustedApplicationPool. Toutefois, si vous souhaitez plus tard rechercher tous les pools d’applications approuvées pour le site NA, vous devez utiliser la valeur Identity dans votre clause where, suivant l’exemple ci-après :

Get-CsTrustedApplicationPool | Where-Object {$_.SiteId –eq "site:Redmond1"}

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

New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Registrar:redmond.litwareinc.com -Site Redmond -ComputerFqdn AppServer.litwareinc.com

L’exemple 2 est identique à l’exemple 1, à ceci près qu’au lieu de spécifier un nom de domaine complet pour le service Serveur d’inscriptions, nous avons utilisé l’ID de service Registrar:redmond.litwareinc.com. De plus, nous avons spécifié le paramètre ComputerFqdn. Lorsqu’un pool est créé, un ordinateur est également créé dans ce pool. Par défaut, l’ordinateur aura le même nom de domaine complet que le pool. Nous avons spécifié un autre nom de domaine complet, AppServer.litwareinc.com, pour l’ordinateur qui se trouve dans ce pool.