New-CsProxyConfiguration
Dernière rubrique modifiée : 2012-03-26
Crée une nouvelle collection de paramètres de configuration d’un serveur proxy.
Syntaxe
New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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>]]
Description détaillée
Microsoft Lync Server 2010 permet de gérer vos serveurs proxy via les paramètres de configuration de 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 nous l’avons souligné, vous pouvez également créer des collections supplémentaires au niveau de l’étendue Service. Ces nouvelles collections sont créées à l’aide de la cmdlet New-CsProxyConfiguration.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsProxyConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique des paramètres de configuration de serveur proxy à créer. Les paramètres de configuration du serveur proxy ne peuvent être créés que pour l’étendue Service et pour les services serveur Edge et Serveur d’inscriptions uniquement. Vous ne pouvez pas créer de paramètres dans l’étendue globale. De même, il n’est possible de créer que des paramètres dans l’étendue Service si le service en question héberge déjà une collection de paramètres pour le serveur proxy. Par exemple, si le service Registrar:atl-cs-001.litwareinc.com héberge déjà des paramètres de serveur proxy, alors toute commande qui essaie de créer de nouveaux paramètres pour ce service échouera. Pour spécifier l’identité des nouveaux paramètres du serveur proxy, utilisez la syntaxe suivante : -Identity "service:Registrar:atl-cs-001.litwareinc.com". |
AcceptClientCompression |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), le serveur proxy acceptera toutes les demandes de compression entrantes des points de terminaison du client. |
AcceptServerCompression |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), le serveur proxy acceptera toutes les demandes de compression entrantes des autres serveurs. |
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. |
DisableNTLMFor2010AndLaterClients |
Facultatif |
Booléen |
S’il est configuré avec la valeur True, les utilisateurs qui se connectent à partir de Microsoft Lync 2010 doivent utiliser le protocole d’authentification Kerberos. La valeur par défaut est False. |
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 maximum de connexions client-serveur pouvant être comprimées à tout moment. Les connexions supplémentaires au-delà de cette limite ne seront pas comprimées. Le compte de compressions peut être défini à n’importe quelle valeur entière comprise entre 0 et 65535 (inclus). La valeur par défaut est 15000. |
MaxClientMessageBodySizeKB |
Facultatif |
Entier |
Taille maximale permise (en kilooctets) pour le corps du message envoyé à partir d’un point de terminaison 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 de message du client peut être configurée pour une valeur entière entre 64 et 256, inclus. |
MaxServerCompressionCount |
Facultatif |
Entier |
Indique le nombre maximum de connexions serveur-client pouvant être comprimées à tout moment. Les connexions supplémentaires au-delà de cette limite ne seront pas comprimées. Le compte de compressions peut être défini à n’importe quelle valeur entière comprise entre 0 et 65535 (inclus). La valeur par défaut est 1024. |
MaxServerMessageBodySizeKB |
Facultatif |
Entier |
Taille maximale permise (en kilooctets) pour le corps du message envoyé à partir d’un autre serveur. La valeur par défaut est 5000, ce qui signifie que les messages plus importants que 5000 Ko seront rejetés. La taille du corps de message du client peut être configurée pour une valeur entière entre 1000 et 20000, 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 minimum de connexions TLS est 1 et le maximum est 4. La valeur par défaut de OutgoingTlsCount est 4. |
Realm |
Facultatif |
Objet SipProxy |
Indique si les informations d’identification de sécurité sont traitées par défaut par le domaine du serveur proxy (SIP Communications Service) 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 |
S’il est configuré avec la valeur True (valeur par défaut), le serveur proxy exige que soit utilisé la compression pour 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 exécutant le service Edge d’accès La valeur par défaut est False. |
UseCertificateForClientToProxyAuth |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), les points de terminaison client seront autorisés à utiliser les certificats pour authentification. |
UseKerberosForClientToProxyAuth |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), les points de terminaison du client seront autorisés à utiliser le protocole Kerberos pour authentification. Bien que le protocole Kerberos soit plus sécurisé que NTLM, il ne peut pas être utilisé si le client appartient à un domaine différent du serveur. |
UseNtlmForClientToProxyAuth |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), les points de terminaison du client seront autorisés à utiliser le protocole NTLM pour 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. Cela ne s’applique pas à 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. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun. New-CsProxyConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsProxyConfiguration crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256
La commande précédente crée une nouvelle collection de paramètres de configuration de serveur proxy pour le service EdgeServer:atl-edge-001.litwareinc.com. Ces nouveaux paramètres utilisent les valeurs de propriété de serveur par défaut sauf deux d’entre elles : RequestServerCompression, qui est configuré avec la valeur True et MaxClientMessageBodySizeKb, qui est configuré avec la valeur 256. Notez que cette commande échouera si les paramètres de serveur proxy ont déjà été configurés pour le service EdgeServer:atl-edge-001.litwareinc.com.
-------------------------- Exemple 2 --------------------------
$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x
Les commandes illustrées à l’exemple 2 indiquent comment créer une collection de paramètres de serveur proxy n’existant qu’en mémoire initialement. Pour ce faire, la première commande appelle New-CsProxyConfiguration ainsi que deux paramètres : L’identité (qui spécifie l’identité des paramètres) et InMemory qui indique que les nouveaux paramètres doivent être créés en mémoire uniquement. L’objet résultant est enregistré dans la variable $x.
Une fois les paramètres virtuels créés, les commandes 2 et 3 sont utilisées pour modifier les valeurs des propriétés RequestServerCompression et MaxClientMessageBodySizeKb respectivement. Enfin, la commande 4 est utilisée pour transformer les paramètres de configuration du serveur proxy en collection effective de paramètres qui seront appliqués au service EdgeServer:atl-edge-001.litwareinc.com. Cette dernière commande est obligatoire. Si vous n’appelez pas la cmdlet Set-CsProxyConfiguration, aucun paramètre ne sera appliqué au service EdgeServer:atl-edge-001.litwareinc.com et les paramètres virtuels disparaîtront dès que vous fermerez votre session Windows PowerShell ou supprimerez la variable $x.
Voir aussi
Autres ressources
Get-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration