Partager via

  • Article

New-CsServerApplication

 

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

Crée une nouvelle application serveur. Les applications serveur sont des applications hébergées par Microsoft Lync Server 2010.

Syntaxe

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

New-CsServerApplication -Name <String> -Parent <String> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les applications serveur font référence aux programmes individuels exécutés sous Microsoft Lync Server 2010. La cmdlet New-CsServerApplication offre aux administrateurs un moyen de configurer de nouvelles applications serveur.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de l’application serveur à créer. 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 : service:Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Parent

Obligatoire

Chaîne

Spécifie le service qui hébergera la nouvelle application serveur. Si vous utilisez le paramètre Identity, les paramètres Parent ou Name sont inutiles, car l’identité de l’application combine les valeurs des propriétés Parent et Name. Cependant, vous pouvez omettre la propriété Identity en utilisant plutôt Parent et Name. Dans ce cas, le paramètre Parent doit se présenter comme suit : -Parent « Registrar:atl-cs-001.litwareinc.com ».

Name

Obligatoire

Chaîne

Nom convivial attribué au service. Si vous utilisez le paramètre Identity, le paramètre Name est inutile lors de la création d’un nouveau service. Au lieu de cela, la propriété Name sera renseignée avec la partie nom de l’identité de l’application. Par exemple, si vous créez une nouvelle application comportant l’identité service:Registrar:atl-cs-001.litwareinc.com/TestService, elle sera automatiquement appelée TestService. Le paramètre Name est uniquement requis si vous utilisez le paramètre Parent.

Uri

Obligatoire

Chaîne

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

Enabled

Facultatif

Booléen

Définissez cette valeur sur True pour activer l’application ou sur False pour la désactiver. Si ce paramètre n'est pas spécifié, la propriété Enabled sera définie sur False et la nouvelle application sera désactivée.

Critical

Facultatif

Booléen

Si le paramètre est défini sur True, 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. Si ce paramètre n'est pas spécifié, la propriété Critical sera définie sur True.

ScriptName

Facultatif

Chaîne

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

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

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

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

Types d’entrées

Aucun. New-CsServerApplication n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsServerApplication crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Exemple

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

New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False

L’exemple 1 illustre la création d’une nouvelle application serveur comportant l’identité EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor. Outre la spécification de l’identité, la commande inclut les paramètres Uri et Critical. Ces derniers permettent de spécifier l’URI de l’application et que l’application n’est pas considérée comme importante.

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

$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x

Les commandes illustrées dans l’exemple 2 expliquent comment créer une nouvelle application serveur à l’origine uniquement existante en mémoire. Pour cela, la première commande appelle New-CsServerApplication ainsi que deux paramètres : Identity (qui spécifie l’identité de l’application) et InMemory, qui indique que la nouvelle application doit être créée en mémoire seulement. L'objet d'application de serveur qui en résulte est alors stocké dans la variable $x.

Une fois cette application serveur virtuelle créée, les commandes 2 et 3 sont utilisées pour modifier les valeurs des propriétés URI et Critical, respectivement. Enfin, la commande 4 est utilisée pour convertir l’application serveur virtuelle en application serveur réelle. Notez que cette commande finale est obligatoire. Si vous n’appelez pas la cmdlet Set-CsServerApplication, aucune application ne sera configurée pour EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor, et l’application virtuelle disparaîtra dès que vous mettez fin à la session Windows PowerShell ou supprimez la variable $x.