Set-CsApplicationServer
Dernière rubrique modifiée : 2012-03-27
Vous permet de modifier les propriétés de configuration d’un ou plusieurs serveurs exécutant le service d’application. Ces serveurs (également appelés Serveurs d’applications) hébergent des programmes logiciels, tels que l’application de parcage d’appel, développés à l’aide du jeu Microsoft Unified Communications Managed API (UCMA).
Syntaxe
Set-CsApplicationServer [-Identity <XdsGlobalRelativeIdentity>] [-ApplicationDatabase <String>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AtsSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-CaaSipPort <UInt16>] [-CasSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-CpsSipPort <UInt16>] [-Force <SwitchParameter>] [-PdpSipPort <UInt16>] [-PdpTurnPort <UInt16>] [-Registrar <String>] [-RgsSipPort <UInt16>] [-RgsWcfMtlsPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Le service d’application héberge plusieurs programmes Microsoft Lync Server 2010 qui ne font pas partie des composantes du serveur principal. Ces programmes comprennent l’application Response Group, l’application Intendant Conférence et l’application d’annonce de conférence. Le service d’application intègre pleinement ces programmes dans l’environnement Lync Server 2010.
La cmdlet Set-CsApplicationServer permet aux administrateurs de modifier les paramètres de configuration pour tout ou partie des serveurs d’applications déployés dans leur organisation. Par exemple, vous pouvez modifier les ports utilisés pour l’audio, la vidéo, le partage de trafic ou pour affecter de nouvelles valeurs aux ports utilisés par des applications individuelles telles que l’application Intendant Conférence ou l’application d’annonce de conférence. Sachez qu’à chaque modification des ports, vous devrez redémarrez le service correspondant.
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-CsApplicationServer : 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 "Set-CsApplicationServer"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Emplacement du service du serveur d'applications à modifier. Par exemple : -Identity "ApplicationServer:atl-cs-001.litwareinc.com". Notez que vous pouvez supprimer le préfixe « ApplicationServer: » pour spécifier un serveur d’applications. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
ApplicationDatabase |
Facultatif |
Chaîne |
Emplacement de service de la base de données d’applications. Par exemple : -ApplicationDatabase "ApplicationDatabase:atl-cs-001.litwareinc.com". |
AppSharingPortCount |
Facultatif |
Entier |
Le nombre total de ports affectés au partage d’applications. Les ports actuels qui doivent être ouverts démarrent avec la valeur configurée pour AppSharingPortStart et ceci pour le nombre de ports spécifié par AppSharingPortCount. Ainsi, si AppSharingPortStart est défini sur 60000 et qu’AppSharingPortCount est défini sur 100, alors les ports 60000 à 60099 seront utilisés pour le partage d’applications. |
AppSharingPortStart |
Facultatif |
Entier |
Le premier port dans la gamme de ports affectée au partage d’applications. Par exemple : –AppSharingPortStart 60000. |
AtsSipPort |
Facultatif |
Entier |
Port utilisé pour le service de test audio. |
AudioPortCount |
Facultatif |
Entier |
Le nombre total de ports assignés à l’envoi et à la réception de trafic audio. Les ports actuels qui doivent être ouverts démarrent avec la valeur configurée pour AudioPortStart et ceci pour le nombre de ports spécifié par AudioPortCount. Ainsi, si AudioPortStart est défini sur 60000 et qu’AudioPortCount est défini sur 100, alors les ports 60000 à 60099 seront utilisés pour le trafic audio. |
AudioPortStart |
Facultatif |
Entier |
Le premier port dans la gamme des ports assignés à l’envoi et la réception de trafic audio. Par exemple : –AudioPortStart 60000. |
CaaSipPort |
Facultatif |
Entier |
Port SIP utilisé par l’application Intendant Conférence pour connecter les utilisateurs à une conférence rendez-vous. |
CasSipPort |
Facultatif |
Entier |
Port SIP utilisé par l’application d’annonce de conférence pour lire des annonces (par exemple, « Ken Myer vient de partir ») pendant une conférence. |
CpsSipPort |
Facultatif |
Entier |
Port SIP utilisé par le service de mise en garde d’appels. Le service de mise en garde d’appels vous permet de mettre un appel en attente, puis de le récupérer sur un autre téléphone. |
PdpSipPort |
Facultatif |
Entier |
Port SIP utilisé par le serveur point de décision de stratégie. Le serveur point de décision de stratégie est utilisé pour gérer la bande passante. |
PdpTurnPort |
Facultatif |
Entier |
Gère le port de trafic utilisé par le serveur point de décision de stratégie. |
Registrar |
Facultatif |
Chaîne |
Nom de domaine complet du serveur d’inscriptions avancé associé au serveur de point de décision de stratégie (PDP). |
RgsSipPort |
Facultatif |
Entier |
Port SIP utilisé par l’application Response Group. L’application Response Group permet de diriger des appels entrants vers un groupe de personnes particulier, comme l'équipe de support d'une organisation. |
RgsWcfMtlsPort |
Facultatif |
Entier |
Port utilisé pour le trafic TLS (MTLS) de Windows Communication Foundation (WCF) par l’application Response Group. |
VideoPortCount |
Facultatif |
Entier |
Le nombre total de ports assignés à l’envoi et à la réception de trafic vidéo. Les ports actuels qui doivent être ouverts démarrent avec la valeur configurée pour VideoPortStart et ceci pour le nombre de ports spécifié par VideoPortCount. Ainsi, si VideoPortStart est défini sur 60000 et que VideoPortCount est défini sur 100, alors les ports 60000 à 60099 seront utilisés pour le trafic vidéo. |
VideoPortStart |
Facultatif |
Entier |
Le premier port dans la gamme des ports assignés à l’envoi et la réception de trafic vidéo. Par exemple –VideoPortStart 60000. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
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. Set-CsApplicationServer n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsApplicationServer ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet modifie des instances existantes de l’objet Microsoft.Rtc.Management.Xds.DisplayApplicationServer.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -CasSipPort 5074
La commande illustrée à l’exemple 1 configure la valeur 5074 pour le port SIP de l’application d’annonce de conférence sur le serveur d’applications ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 2 --------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -AudioPortStart 49500 -AudioPortCount 5500
La commande précédente configure les ports audio pour le serveur d’applications ApplicationServer:atl-cs-001.litwareinc.com. Dans cet exemple, le premier port audio est configuré avec la valeur 49500 et un total de 5500 ports sont mis en réserve pour le trafic audio.
-------------------------- Exemple 3 --------------------------
Get-CsService -ApplicationServer | ForEach-Object {Set-CsApplicationServer -Identity $_.Identity -CasSipPort 5074}
Dans l’exemple 3, le port SIP du l’application d’annonce de conférence est configuré avec la valeur 5074 pour tous les serveurs d’applications dans l’organisation. Pour ce faire, la commande utilise d’abord Get-CsService pour retourner une collection de tous les serveurs d'applications utilisés actuellement. La collection est ensuite redirigée vers la cmdlet ForEach-Object qui choisit chaque serveur dans la collection et utilise Set-CsApplicationServer pour définir le port SIP de l’application d’annonce de conférence sur 5074.