Partager via

  • Article

Remove-CsProxyConfiguration

 

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

Supprime une collection existante de paramètres de configuration du serveur proxy.

Syntaxe

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

Description détaillée

Microsoft Lync Server 2010 vous permet de gérer les serveurs proxy grâce aux paramètres de configuration du serveur proxy. Ces paramètres, qui peuvent être appliqués à la fois au niveau de l’étendue globale et au niveau de l’étendue Service (mais uniquement pour les services Serveur d’inscriptions et ceux liés au serveur Edge) permettent de contrôler, entre autres, les protocoles d’authentification pouvant être utilisés par les systèmes d’extrémité clients et l’utilisation ou non de la compression sur les connexions entrantes et sortantes du serveur proxy. Lorsque vous installez Lync Server 2010, une collection globale des paramètres de configuration de serveur proxy est automatiquement créée pour vous. Comme vous avez pu le noter, vous pouvez également créer des collections supplémentaires dans l’étendue du service.

Tout nouveau paramètre du serveur proxy que vous créez peut ensuite être supprimé à l’aide de la cmdlet Remove-CsProxyConfiguration. Vous pouvez également exécuter Remove-CsProxyConfiguration sur la collection globale. Cependant, dans ce cas, les paramètres globaux ne seront pas supprimés car Lync Server ne vous permet pas de supprimer les paramètres globaux. Au lieu de cela, toutes les propriétés de cette stratégie globale seront réinitialisées à leur valeur par défaut. Par exemple, les paramètres de serveur proxy autoriseront par défaut les clients à utiliser le protocole Kerberos pour authentification. Vous pouvez modifier les paramètres globaux pour désactiver l’utilisation de Kerberos. Cependant, vous pouvez exécuter Remove-CsProxyConfiguration sur toute la collection globale et la propriété en question (UseKerberosForClientToProxyAuth) sera réinitialisée à sa valeur par défaut, tandis que Kerberos sera à nouveau activé comme protocole d’authentification.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration du serveur proxy à supprimer. Par exemple : -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Remove-CsProxyConfiguration peut également être exécuté par rapport aux paramètres globaux. Dans ce cas, la stratégie ne sera pas supprimée cependant. Au lieu de cela, les propriétés de cette stratégie globale seront réinitialisées à leur valeur par défaut.

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.SipProxy.ProxySettings. Remove-CsProxyConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres proxy.

Types de retours

Aucun. Au lieu de cela, Remove-CsProxyConfiguration supprime des instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Exemple

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

Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com

La commande présentée dans l’exemple 1 supprime les paramètres de configuration proxy dont la propriété Identity est service:EdgeServer:atl-edge-litwareinc.com.

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

Get-CsProxyConfiguration -Filter "service:*" | Remove-CsProxyConfiguration

Dans l’exemple 2, tous les paramètres de configuration de serveur proxy appliqués à l’étendue du service sont supprimés. Pour cette tâche, la commande appelle d’abord Get-CsProxyConfiguration ainsi que le paramètre Filter. La valeur de filtre « service:* » garantit que seuls les paramètres de serveur proxy ayant une identité qui commence par la valeur de chaîne « service: » seront renvoyés. La collection filtrée est ensuite redirigée vers Remove-CsProxyConfiguration qui supprime chaque élément dans la collection.

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

Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration

La commande précédente supprime tous les paramètres de configuration du serveur proxy pour traiter les clients comme des clients distants. Pour ce faire, Get-CsProxyConfiguration est d’abord appelée sans paramètre afin de retourner une collection de tous les paramètres de configuration du serveur proxy utilisés actuellement. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété TreatAllClientsAsRemote est égale à True. Ce sous-ensemble de paramètres de configuration du serveur proxy est ensuite redirigé vers Remove-CsProxyConfiguration pour supprimer tous les paramètres dans la collection.