Get-CsProxyConfiguration
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les paramètres de configuration de serveur proxy utilisés dans votre organisation.
Syntaxe
Get-CsProxyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <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.
La cmdlet Get-CsProxyConfiguration vous permet de retourner des informations les paramètres de configuration de serveur proxy actuellement utilisés dans votre organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsProxyConfiguration : RTCUniversalUserAdmins, 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 "Get-CsProxyConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique des paramètres de configuration de serveur proxy à retourner. Pour retourner les paramètres globaux, utilisez la syntaxe suivante : -Identity global. Pour retourner les paramètres configurés au niveau de l’étendue Service, utilisez une syntaxe du type : -Identity "service:EdgeServer:atl-cs-001.litwareinc.com". Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité. Si vous voulez (ou devez) utiliser des caractères génériques, servez-vous du paramètre Filter. Si ce paramètre n’est pas inclus, Get-CsProxyConfiguration retournera tous les paramètres de configuration de serveur proxy actuellement utilisés dans votre organisation. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques afin de spécifier les paramètres de configuration proxy à retourner. Par exemple, cette syntaxe retourne tous les paramètres configurés au niveau de l’étendue Service : -Filter "service:*". Vous ne pouvez pas utiliser à la fois les paramètres Filter et Identity dans la même commande. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Récupère les données de configuration proxy à partir du réplica local du magasin central de gestion et non depuis le magasin central de gestion lui-même. |
Types d’entrées
Aucun. Get-CsProxyConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsProxyConfiguration retourne les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsProxyConfiguration
La commande présentée dans l’exemple 1 retourne une collection de tous les paramètres de configuration proxy actuellement utilisés dans votre organisation. Cela s’effectue par l’appel de Get-CsProxyConfiguration sans paramètre.
-------------------------- Exemple 2 --------------------------
Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"
L’exemple 2 retourne les informations relatives aux paramètres de configuration proxy dont la propriété Identity est service:EdgeServer:atl-cs-001.litwareinc.com. Tenant compte du caractère unique des identités, cette commande ne retourne jamais plus d’une collection de paramètres.
-------------------------- Exemple 3 --------------------------
Get-CsProxyConfiguration -Filter "service:*"
La commande ci-dessus retourne des informations sur tous les paramètres proxy qui ont été configurés au niveau de l’étendue Service. Pour ce faire, la commande appelle Get-CsProxyConfiguration avec le paramètre Filter ; la valeur de filtre « service:* » garantit que seuls les paramètres dont l’identité commence par la valeur de chaîne « service: » sont retournés.
-------------------------- Exemple 4 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}
L’exemple 4 retourne des informations sur les paramètres de configuration proxy qui n’autorisent pas l’utilisation des certificats clients comme un mécanisme d’authentification. Pour effectuer cette tâche, la commande utilise d’abord Get-CsProxyConfiguration pour retourner une collection de tous les paramètres de configuration proxy actuellement utilisés. Cette collection est alors redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres dont la propriété UseCertificateForClientToProxyAuth est égale à False.
-------------------------- Exemple 5 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}
La commande précédente retourne tous les paramètres de configuration proxy dont la taille maximale du corps d’un message de client est inférieure à 5000 kilo-octets. Pour ce faire, la commande appelle d’abord Get-CsProxyConfiguration sans paramètre, ce qui retourne une collection de tous les paramètres de configuration proxy actuellement utilisés. Cette collection est ensuite redirigée vers Where-Object qui choisit les paramètres dont la propriété MaxClientMessageBodySizeKb est inférieure à 5000 kilo-octets.
Voir aussi
Autres ressources
New-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration