Partager via


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.