Partager via

  • Article

Get-CsWebServiceConfiguration

 

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

Retourne des informations sur les paramètres de configuration du services Web utilisés dans votre organisation.

Syntaxe

Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <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 à l'échelle de 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 au niveau de l’étendue globale, ainsi qu’au niveau des étendues Site et Service (service Services Web uniquement), vous pouvez personnaliser les capacités des services Web pour les différents utilisateurs et les différents emplacements.

La cmdlet Get-CsWebServiceConfiguration vous permet de retourner des informations détaillées sur les paramètres de configuration des services Web 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-CsWebServiceConfiguration : 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-CsWebServiceConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

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

Vous ne pouvez pas utiliser à la fois les paramètres Filter et Identity dans la même commande. Si vous ne spécifiez pas de paramètre, Get-CsWebServiceConfiguration retournera toutes les collections de paramètres de configuration des services Web actuellement utilisés dans votre organisation.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lors de la spécification d’une ou plusieurs collections de configurations de services Web à retourner. Par exemple, cette syntaxe retourne tous les paramètres configurés au niveau de l’étendue Site : -Filter "site:*".

Vous ne pouvez pas utiliser à la fois les paramètres Filter et Identity dans la même commande.

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de configuration des services Web du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit.

Types d’entrées

Aucun. Get-CsWebServiceConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsWebServiceConfiguration retourne des instances de l'objet Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings.

Exemple

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

Get-CsWebServiceConfiguration

La commande ci-dessus retourne des informations sur tous les paramètres de configuration des services Web utilisés dans l’organisation.

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

Get-CsWebServiceConfiguration -Identity site:Redmond

La commande illustrée dans l’exemple 2 retourne des informations sur les paramètres de configuration des services Web dont le paramètre Identity est site:Redmond.

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

Get-CsWebServiceConfiguration -Filter "site:*"

L’exemple 3 retourne tous les paramètres de configuration des services Web qui ont été attribués au niveau de l’étendue Site. Pour cela, le paramètre Filter est inclus lors de l’appel à Get-CsWebServiceConfiguration ; la valeur de filtre « site:* » garantit que seuls les paramètres dont une propriété Identity commence par la valeur de chaîne « site: » sont retournés.

-------------------------- Exemple 4 ------------------------

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

Dans l’exemple 4, la commande retourne tous les paramètres de configuration des services Web qui n’autorisent pas l’authentification par code confidentiel. Pour cela, il faut tout d’abord appeler Get-CsWebServiceConfiguration qui retourne tous les paramètres de configuration des services Web actuellement utilisés. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui choisit uniquement les paramètres pour lesquels la propriété UsePinAuth est égale à False.

-------------------------- Exemple 5 ------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}

La commande ci-dessus retourne tous les paramètres de configuration des services Web dans lesquels la taille de développement de groupes maximale est supérieure à 100. Pour cela, la commande utilise d’abordGet-CsWebServiceConfiguration pour retourner tous les paramètres de configuration des services Web actuellement utilisés. Ces informations sont ensuite redirigées vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres pour lesquels la propriété MaxGroupSizeToExpand est supérieure à 100.