Partager via

  • Article

Remove-CsWebServiceConfiguration

 

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

Supprime une ou plusieurs collections de paramètres de configuration de services Web.

Syntaxe

Remove-CsWebServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Bon nombre de composants Microsoft Lync Server 2010 sont disponibles en ligne : ces composants utilisent soit les services Web, soit les pages Web pour effectuer leurs tâches. Par exemple, les utilisateurs utilisent un service Web pour rechercher de nouveaux contacts dans le carnet d’adresses ou lorsqu’ils ont recours au développement de groupes pour afficher les membres individuels d’un groupe de distribution. De la même manière, plusieurs composants, allant des conférences rendez-vous à Panneau de configuration Microsoft Lync Server 2010, utilisent des pages Web en guise d’interface entre Lync Server 2010 et les utilisateurs.

Les cmdlets CsWebServiceConfiguration permettent aux administrateurs de gérer les paramètres de configuration des services Web dans toute l’organisation. Ceci inclut la gestion du développement de groupes, des paramètres de certificat et des méthodes d’authentification autorisées. Puisque vous configurez les différents paramètres dans l’étendue globale, de site et de service (service Web Services uniquement), vous pouvez personnaliser les capacités du services Web pour les différents utilisateurs et les différents emplacements.

Si vous créez des paramètres de configuration de services Web personnalisés dans l’étendue Site ou Service, vous pouvez les supprimer ultérieurement à l’aide de la cmdlet Remove-CsWebServiceConfiguration. Notez que vous pouvez également exécuter la cmdlet Remove-CsWebServiceConfiguration dans la collection globale des paramètres de services Web. Dans ce cas toutefois, la collection globale ne sera pas supprimée, car Lync Server n’autorise pas la suppression des paramètres globaux. Au lieu de cela, les valeurs par défaut de toutes les propriétés de la collection globale sont rétablies. Par exemple, supposons que vous ayez modifié la valeur de MaxGroupSizeToExpand à 500. Étant donné que la valeur par défaut de cette propriété est égale à 100, la « suppression » de la collection globale entraînera la réinitialisation de la valeur de la propriété MaxGroupSizeToExpand à 100.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration des services Web à supprimer. Pour supprimer les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe du type : -Identity "site:Redmond". Pour supprimer les paramètres configurés dans l’étendue Service, utilisez une syntaxe similaire à celle-ci : -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Vous pouvez également exécuter la cmdlet Remove-CsWebServiceConfiguration dans la collection globale. Dans ce cas toutefois, la collection globale ne sera pas supprimée. Au lieu de cela, les valeurs par défaut de toutes les propriétés de cette collection seront rétablies. Pour réinitialiser la collection globale, utilisez la syntaxe suivante : -Identity global.

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

Paramètre de commutateur

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

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Remove-CsWebServiceConfiguration accepte la saisie de données transmises via le pipeline pour l’objet de paramètre des services Web.

Types de retours

Aucun. Remove-CsWebServiceConfiguration supprime les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.

Exemple

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

Remove-CsWebServiceConfiguration -Identity site:Redmond

La commande ci-dessus supprime les paramètres de configuration des services Web pour le site de Redmond.

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

Get-CsWebServiceConfiguration -Filter "site:*" | Remove-CsWebServiceConfiguration

Dans l’exemple 2, tous les paramètres des services Web configurés dans l’étendue Site sont supprimés. Pour exécuter cette tâche, la commande appelle d’abord Get-CsWebServiceConfiguration et inclut le paramètre Filter. La valeur de filtre « site:* » s’assure que seuls les paramètres dont l’identité commence par les caractères « site: » sont retournés. Cette collection filtrée est ensuite redirigée vers la cmdlet Remove-CsWebServiceConfiguration qui supprime chaque élément.

-------------------------- Exemple 3 ------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration

La commande illustrée dans l’exemple 3 supprime tous les paramètres de configuration des services Web pour lesquels le développement de groupes a été désactivé. Pour ce faire, la commande appelle d’abord la cmdlet Get-CsWebServiceConfiguration sans aucun paramètre afin de retourner une collection de tous les paramètres de configuration des services Web utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété EnableGroupExpansion est égale à False. Cette collection filtrée est ensuite redirigée vers Remove-CsWebServiceConfiguration qui supprime chaque élément.