Partager via

  • Article

Set-CsProxyConfiguration

 

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

Modifie une collection existante de paramètres de configuration de serveurs proxy.

Syntaxe

Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Microsoft Lync Server 2010 vous permet de gérer vos serveurs proxy à travers les paramètres de configuration de serveurs 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 nous l’avons souligné, vous pouvez également créer des collections supplémentaires au niveau de l’étendue Service.

La cmdlet Set-CsProxyConfiguration vous permet de modifier les valeurs de propriétés d’une collection existante de paramètres de configuration de serveurs proxy.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsProxyConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration de serveurs proxy à modifier. Pour modifier les paramètres globaux, utilisez la syntaxe suivante : -Identity global. Pour modifier les paramètres configurés au niveau de l’étendue Service, utilisez une syntaxe du type : -Identity "service: EdgeServer:atl-edge-001.litwareinc.com".

Si ce paramètre n’est pas inclus, Set-CsProxyConfiguration modifie automatiquement les paramètres globaux.

Instance

Facultatif

Objet ProxySettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

AcceptClientCompression

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), le serveur proxy accepte toutes les demandes de compression entrantes des points de terminaison des clients.

AcceptServerCompression

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), le serveur proxy accepte toutes les demandes de compression entrantes d’autres serveurs.

DisableNTLMFor2010AndLaterClients

Facultatif

Booléen

Lorsque ce paramètre est défini sur True, les utilisateurs qui se connectent à partir de Microsoft Lync 2010 doivent utiliser le protocole Kerberos pour l’authentification. La valeur par défaut est False.

DNSCacheRecordCount

Facultatif

Entier

Nombre maximal d’enregistrements qui peuvent être conservés dans le cache d’enregistrement DNS. La valeur par défaut est 30 000.

EnableWhiteSpaceKeepAlive

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), le serveur proxy s’attend à ce que les clients envoient régulièrement un message vide pour indiquer que leur connexion est toujours active.

MaxClientCompressionCount

Facultatif

Entier

Indique le nombre maximal de connexions client-serveur pouvant être compressées à un moment donné ; les connexions supplémentaires se trouvant au-delà de cette limite ne seront pas compressées. Le nombre de compressions peut être défini sur toute valeur entière comprise entre 0 et 65 535, inclus. La valeur par défaut est 15 000.

MaxClientMessageBodySizeKB

Facultatif

Entier

Taille maximale autorisée (en kilooctets) pour le corps d’un message envoyé à partir d’un point de terminaison de client. La valeur par défaut est 128, ce qui signifie que les messages dont la taille est supérieure à 128 Ko seront rejetés. La taille du corps du message client peut être redéfinie sur toute valeur entière comprise entre 64 et 256, inclus.

MaxServerCompressionCount

Facultatif

Entier

Indique le nombre maximal de connexions serveur-serveur pouvant être compressées à un moment donné ; les connexions supplémentaires se trouvant au-delà de cette limite ne seront pas compressées. Le nombre de compressions de serveurs peut être défini sur toute valeur entière comprise entre 0 et 65 535, inclus. La valeur par défaut est 1 024.

MaxServerMessageBodySizeKB

Facultatif

Entier

Taille maximale autorisée (en kilooctets) pour le corps d’un message envoyé à partir d’un autre serveur. La valeur par défaut est 5 000, ce qui signifie que les messages dont le corps dépasse 5 000 Ko seront rejetés. La taille du corps du message serveur peut être redéfinie sur toute valeur entière comprise entre 1 000 et 20 000, inclus.

OutgoingTLSCount

Facultatif

Entier

Spécifie le nombre maximum de connexions TLS (Transport Layer Security) qui peut être utilisé pour chaque serveur interne. Le nombre minimal de connexions TLS est 1 ; le nombre maximal est 4. Par défaut, OutgoingTlsCount est défini sur 4.

Realm

Facultatif

Objet SipProxy

Indique si les informations d’identification de sécurité sont traitées par le domaine de serveur proxy par défaut (services de communication SIP) ou par un domaine personnalisé. Les domaines personnalisés doivent être spécifiés (et créés) à l’aide de la cmdlet New-CsSipProxyCustom.

RequestServerCompression

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), le serveur proxy demande que la compression soit utilisée sur toutes les connexions sortantes vers d’autres serveurs.

TreatAllClientsAsRemote

Facultatif

Booléen

S’il est configuré avec la valeur True, le serveur proxy fonctionne comme si toutes les connexions client étaient des connexions externes transitant par le serveur Edge. La valeur par défaut est False.

UseCertificateForClientToProxyAuth

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), les points de terminaison des clients sont autorisés à utiliser des certificats pour l’authentification.

UseKerberosForClientToProxyAuth

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), les points de terminaison des clients sont autorisés à utiliser le protocole Kerberos pour l’authentification. Bien que Kerberos soit un protocole plus sûr que NTLM, il ne peut pas être utilisé si le client appartient à un autre domaine que le serveur.

UseNtlmForClientToProxyAuth

Facultatif

Booléen

Lorsque ce paramètre est défini sur True (valeur par défaut), les points de terminaison des clients sont autorisés à utiliser le protocole NTLM pour l’authentification. Bien que le protocole NTLM soit moins sécurisé que Kerberos, il peut être utilisé même si le client appartient à un domaine différent du serveur. Ce n’est pas le cas avec l’authentification Kerberos.

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

Types de retours

Set-CsProxyConfiguration ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Exemple

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

Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True

Dans l’exemple 1, les paramètres de configuration proxy dont la propriété Identity est service:EdgeServer:atl-edge-001.litwareinc.com sont modifiés pour accepter la compression de serveur. Pour cela, Set-CsProxyConfiguration et le paramètre AcceptServerCompression sont appelés, et la valeur du paramètre est définie sur True.

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

Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True

La commande ci-dessus trouve tous les paramètres de configuration proxy qui acceptent la compression de serveur, puis les modifie pour qu’ils acceptent également la compression de client. Pour cela, la commande appelle d’abord Get-CsProxyConfiguration sans paramètre afin de retourner une collection de tous les paramètres proxy utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui choisit uniquement les paramètres pour lesquels la propriété AcceptServerCompression est égale à True. Cette collection filtrée est ensuite redirigée vers Set-CsProxyConfiguration, qui prend chaque élément de la collection et définit la propriété AcceptClientCompression sur True.

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

Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False

L’exemple 3 illustre comment vous pouvez modifier tous les paramètres proxy qui ont été configurés au niveau de l’étendue Service. Pour cela, la commande appelle d’abord Get-CsProxyConfiguration et inclut le paramètre Filter ; la valeur de filtre « service:* » garantit que seuls les paramètres dont la propriété Identity commence par la valeur de chaîne « service: » sont retournés. Cette collection filtrée est ensuite redirigée vers Set-CsProxyConfiguration, qui prend chaque élément de la collection et définit la propriété UseNtlmForClientToProxyAuth sur False.