Partager via

  • Article

Set-CsServerApplication

 

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

Modifie les valeurs de propriété d’une application serveur existante. Les applications serveur sont des applications hébergées par Microsoft Lync Server 2010.

Syntaxe

Set-CsServerApplication [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsServerApplication [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les applications serveur font référence aux programmes individuels exécutés sous Lync Server 2010. La cmdlet Set-CsServerApplication offre un moyen aux administrateurs de modifier les valeurs des propriétés de n’importe quelle application exécutée dans le cadre de Lync Server.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de l’application serveur à modifier. Les identités de l’application serveur se composent du service où l’application est hébergée et du nom de l’application. Par exemple, l’application serveur appelée QoEAgent peut comporter une identité similaire à celle-ci : Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Instance

Facultatif

Objet ServerApplication.Application

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

Critical

Facultatif

Booléen

Si le paramètre est défini sur True (valeur par défaut), Lync Server ne démarre pas, sauf si l’application en question peut être lancée. S’il est défini sur False, Lync Server démarre, que l’application puisse être ou non lancée.

Enabled

Facultatif

Booléen

Définissez cette valeur sur True pour activer l’application ou sur False pour la désactiver.

Priority

Facultatif

Entier

Indique l’ordre d’exécution des applications serveur. L’application à laquelle la priorité 0 est affectée démarre en premier, suivie de celle ayant la priorité 1, etc. Notez que chaque service hébergeant une application serveur possède son propre ensemble de priorités. Par exemple, le service Serveur d’inscriptions peut héberger trois applications avec les priorités correspondantes 0, 1 et 2. De même, le service du serveur Edge peut héberger quatre applications, auxquelles les priorités 0, 1, 2 et 3 seront affectées.

Si vous ne spécifiez aucune priorité, l’application sera automatiquement ajoutée au bas de la liste des priorités. Si vous ajoutez ou supprimez une application, les priorités des autres applications seront ajustées en conséquence. Par exemple, si vous supprimez une application dont la priorité est 0, l’application auparavant dotée de la priorité 1 verra automatiquement sa propriété définie sur 0.

ScriptName

Facultatif

Chaîne

Chemin d’accès au script MSPL (Microsoft SIP Processing Language) utilisé par l’application. MSPL est un langage de script utilisé pour filtrer et acheminer des messages SIP.

Uri

Facultatif

Chaîne

URI (Uniform Resource Identifier) unique de l’application. Par exemple, l’application QoEAgent possède l’URI https://www.microsoft.com/LCS/QoEAgent.

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.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter 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.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Set-CsServerApplication accepte les instances transmises via le pipeline de l’objet de l’application serveur.

Types de retours

Set-CsServerApplication ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application.

Exemple

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

Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True

La commande affichée dans l’exemple 1 active l’application serveur dotée de l’identité (Identity) Registrar:atl-cs-001.litwareinc.com/ExumRouting. Les identités devant être uniques, cette commande active uniquement une seule application serveur.

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

Get-CsServerApplication | Where-Object {$_.Enabled -eq $False} | Set-CsServerApplication -Enabled $True

La commande ci-dessus active toutes les applications serveur actuellement désactivées. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsServerApplication pour récupérer une collection de toutes les applications serveur utilisées dans l’organisation. Cette collection est ensuite redirigée vers Where-Object qui choisit uniquement les applications pour lesquelles la propriété Enabled est égale à False. À son tour, la collection filtrée est redirigée vers Set-CsServerApplication, qui extrait chaque élément de la collection et définit la propriété Enabled sur True.