Remove-CsServerApplication
Dernière rubrique modifiée : 2012-03-27
Supprime une application de serveur existant. Les applications de serveur sont les applications hébergées par Microsoft Lync Server 2010.
Syntaxe
Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 Remove-CsServerApplication permet aux administrateurs de supprimer toute application exécutée dans le cadre de Lync Server Notez que le fait de supprimer une application de serveur n’est pas la même chose que la désinstaller. Quand vous exécutez Remove-CsServerApplication l’application n’est plus exécutée sous Lync Server. Cependant, le logiciel lui-même n’est pas désinstallé et l’application peut être réactivée en exécutant New-CsServerApplication.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsServerApplication }
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique pour l’application de serveur à supprimer. Les identités de l’application de serveur sont composées du service où l’application est hébergée et du nom de l’application. Par exemple, l’application de serveur appelée QoEAgent pourra avoir une identité semblable à ceci : service:Registrar:atl-cs-001.litwareinc.com/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. |
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
Objet Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Remove-CsServerApplication accepte les instances transmises via le pipeline de l’objet de l’application serveur.
Types de retours
Remove-CsServerApplication supprime des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"
Dans l’exemple 1, l’application serveur qui possède l’identité service: EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor est supprimée. Puisque les identités doivent être uniques, cette commande ne supprimera jamais plus d’une seule application.
-------------------------- Exemple 2 --------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $False} | Remove-CsServerApplication
Dans l’exemple 2, toutes les applications serveur non critiques sont supprimées. Pour effectuer cette tâche, la commande appelle d’abord Get-CsServerApplication afin de retourner une collection de toutes les applications serveur utilisées actuellement dans l’organisation. La collection est ensuite acheminée vers Where-Object qui sélectionne toutes les applications dont la propriété critique est égale à False. La collection filtrée est ensuite acheminée vers Remove-CsServerApplication qui supprime chaque élément de la collection.
-------------------------- Exemple 3 --------------------------
Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication
La commande précédente restaure toutes les applications de serveur configurées pour le service EdgeServer:atl-cs-001.litwareinc.com. Pour ce faire, Get-CsServerApplication est utilisée avec le paramètre de filtre. La valeur de filtre « service:EdgeServer:atl-cs-001.litwareinc.com/* » retourne toutes les applications dont l’identité commence par les caractères « service:EdgeServer:atl-cs-001.litwareinc.com/ ». Puis, la collection est acheminée vers Remove-CsServerApplication qui supprime alors chaque application dans EdgeServer:atl-cs-001.litwareinc.com.
Voir aussi
Autres ressources
Get-CsServerApplication
New-CsServerApplication
Set-CsServerApplication