Set-CsWebServiceConfiguration
Dernière rubrique modifiée : 2012-04-23
Modifie une collection existante de paramètres de la configuration de services Web.
Syntaxe
Set-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Set-CsWebServiceConfiguration [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-Instance <PSObject>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<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 dans toute l’organisation. Cela comprend la gestion du développement de groupe, les paramètres de certificat et les 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. Les cmdlets CsWebServiceConfiguration (Get-CsWebServiceConfiguration, New-CsWebServiceConfiguration, Remove-CsWebServiceConfiguration etSet-CsWebServiceConfiguration) permettent aux administrateurs de gérer les paramètres de configuration de services Web dans l’ensemble de l’organisation. Cela comprend le développement du groupe de gestion, les paramètres de certificat et les 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.
Les paramètres personnalisés (par exemple, les périodes de validité personnalisées pour les certificats) peuvent être spécifiés au moment où vous créez une nouvelle collection de paramètres de configuration des services Web. Sinon, vous pouvez modifier les valeurs de la propriété pour une collection existante en utilisant la cmdlet Set-CsWebServiceConfiguration.
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-CsWebServiceConfiguration : 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-CsWebServiceConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique des paramètres de configuration des services Web à modifier. Pour modifier des paramètres configurés au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Pour modifier des paramètres configurés au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity "service:WebServer:atl-cs-001.litwareinc.com". Pour modifier des paramètres configurés au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity global. Si le paramètre d’identité n’est pas utilisé, alors Set-CsWebServiceConfiguration modifiera automatiquement la collection globale. |
Instance |
Obligatoire |
Objet WebServiceSettings |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
AllowAnonymousAccessToLWAConference |
Facultatif |
Booléen |
S’il est configuré avec la valeur True, les utilisateurs anonymes sont autorisés à assister à des conférences Lync Web App (LWA). |
CASigningKeyLength |
Facultatif |
Entier |
Définit la taille de la clé de signature CA, la clé privée utilisée par une autorité de certification (CA) pour signer les certificats numériques. La longueur de la clé peut être configurée pour n’importe quelle valeur entière entre 2048 et 16384 octets, la valeur par défaut étant de 2048. |
DefaultValidityPeriodHours |
Facultatif |
Entier |
Les clients qui utilisent l’authentification par certificat peuvent demander une période de validité (en heures) pour ce certificat. DefaultValidityPeriodHours représente la période de validité d’un certificat si le client n’en fait pas la demande. DefaultValidityPeriodHours peut être un nombre entier entre 8 et 8760 (en heures, pour 365 jours). La valeur par défaut est 4320 secondes (180 jours). |
EnableCertChainDownload |
Facultatif |
Booléen |
S’il est configuré avec la valeur True, les serveurs à qui l’on présente un certificat d’authentification téléchargeront la chaîne correspondante à ce certificat. La chaîne de certificat authentifie un certificat individuel auprès de l’autorité CA de délivrance. Les certificats ne seront acceptés pour authentification que si l’autorité CA a été approuvée. |
EnableGroupExpansion |
Facultatif |
S’il est configuré avec la valeur True, le développement du groupe sera activé dans Microsoft Lync 2010. Avec le développement de groupe, les utilisateurs peuvent configurer un groupe de distribution comme contact, puis « élargir » ce groupe. Une fois le groupe développé, les utilisateurs peuvent afficher les membres individuels d’un groupe et leurs informations de présence. |
|
InferCertChainFromSSL |
Facultatif |
Booléen |
S’il est configuré avec la valeur True, les serveurs utiliseront les informations de certificat incluses dans le protocole SSL pour déterminer l’autorité de certification de délivrance. Les certificats ne seront acceptés pour authentification que si l’autorité CA a été approuvée. |
MACResolverUrl |
Facultatif |
Chaîne |
URL d’un service Web capable d’effectuer une résolution Media Access Control (MAC). Une résolution MAC implique de choisir une adresse IP et de déterminer l’adresse MAC de la carte de réseau associée à cette adresse. |
MaxCSRKeySize |
Facultatif |
Entier |
Configure la taille maximale de la clé de demande de signature de certificat (CSR). (Une demande CSR est un message envoyé par un candidat souhaitant obtenir un certificat d’authentification pour faire une demande de certificat numérique.) Le taille maximale d’une clé CSR peut être comprise entre n’importe quel entier compris entre 1024 et 16384. La valeur par défaut est 16 384. |
MaxGroupSizeToExpand |
Facultatif |
Entier |
Représente le nombre maximal de personnes qui seront affichées quand un groupe sera développé. Par exemple, si MaxGroupSizeToExpand est configuré avec la valeur 75, seuls les 75 premiers membres du groupe seront affichés chaque fois que le groupe est élargi. MaxGroupSizeToExpand peut être défini pour n’importe quel entier compris entre 1 et 1000 (inclus). La valeur par défaut est 100. |
MaxValidityPeriodHours |
Facultatif |
Entier |
Les clients qui utilisent l’authentification par certificat peuvent demander une période de validité (en heures) pour ce certificat. MaxValidityPeriodHours représente la période maximale qu’un client pourra demander. MaxValidityPeriodHours peut être un nombre entier entre 8 et 8760 (en heures, pour 365 jours). La valeur par défaut est 8760. |
MinCSRKeySize |
Facultatif |
Entier |
Configure la taille maximale de la clé de demande de signature de certificat (CSR). La taille minimale peut être comprise entre n’importe quel entier compris entre 1024 et 16384. La valeur par défaut est 16384. |
MinValidityPeriodHours |
Facultatif |
Entier |
Les clients qui utilisent l’authentification par certificat peuvent demander une période de validité (en heures) pour ce certificat. MaxValidityPeriodHours représente la période minimale qu’un client pourra demander. MaxValidityPeriodHours peut être un nombre entier entre 8 et 4320 (en heures, pour 180 jours). La valeur par défaut est 8. |
SecondaryLocationSourceUrl |
Facultatif |
Chaîne |
URL d’un service Web pouvant traiter une demande d’emplacement. Ce service est généralement utilisé uniquement quand les demandes de d’emplacement ne peuvent pas être résolues localement. |
ShowDownloadCommunicatorAttendeeLink |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), les utilisateurs qui rejoignent une réunion à l’aide d’une application cliente autre que Lync 2010 verront un lien qui les dirige vers le téléchargement de Lync 2010 Attendee. |
ShowJoinUsingLegacyClientLink |
Facultatif |
Booléen |
S’il est configuré avec la valeur True, les utilisateurs rejoignant une réunion à l’aide d’une application cliente autre que Lync 2010 pourront la rejoindre en utilisant cette application. La valeur par défaut est False. |
TrustedCACerts |
Facultatif |
Collection de certificats |
La collection de certificats représentant les chaînes de certificats approuvées par le serveur Web. Les nouveaux certificats ajoutés à la collection doivent être créés à l’aide de la cmdlet New-CsWebTrustedCACertificate. La collection n’est pas utilisée si la propriété InferCertChainFromSSL est configurée avec la valeur True. |
UseCertificateAuth |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), les clients pourront être authentifiés à l’aide de certificats. Configurez cette valeur sur False pour désactiver l’authentification par certificat. |
UsePinAuth |
Facultatif |
Booléen |
S’il est configuré avec la valeur True (valeur par défaut), les clients pourront être authentifiés à l’aide d’un code confidentiel PIN. Configurez cette valeur sur False pour désactiver l’authentification par code confidentiel. |
UseWindowsAuth |
Facultatif |
Modificateur de liste PS |
Détermine comment (et si) les utilisateurs doivent être authentifiés à l’aide de l’authentification de Windows, à l’aide du même nom que les informations d’authentification utilisées quand ils se connectent à Windows. Les valeurs valides sont les suivantes : Negotiate – Le client et le serveur travaillent ensemble pour déterminer le protocole d’authentification qui convient (Kerberos ou NTLM). NTLM – L’authentification Windows sera autorisée, mais avec le protocole NTLM uniquement. None – l’authentification Windows ne sera pas autorisée. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation ou les messages d’erreur récupérable qui peuvent s’afficher lors de l’exécution de la cmdlet. |
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.Web.WebServiceSettings. Set-CsWebServiceConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres des services Web.
Types de retours
Set-CsWebServiceConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $True
L’exemple 1 permet de développer le groupe de paramètres de configuration des services Web qui sera appliqué au site Redmond (-Identity site:Redmond). Il suffit d’incorporer la propriété EnableGroupExpansion et de configurer la valeur de paramètre sur True.
-------------------------- Exemple 2 --------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Set-CsWebServiceConfiguration -MaxValidityPeriodHours 16
Dans l’exemple 2, la période de validité maximale pour les paramètres de configuration des services Web appliqués au niveau de l’étendue Site est modifiée à 16 heures. Pour effectuer cette tache, on appelle, Get-CsWebServiceConfiguration ainsi que la paramètre Filter. La valeur de filtre « site:* » limite les données renvoyées aux paramètres dont l’identité commence par les caractères « site: ». Cette collection filtrée est ensuite redirigée vers Set-CsWebServiceConfiguration qui prend chaque élément dans la collection et donne à la propriété MaxValidityPeriodHours la valeur 16.
-------------------------- Exemple 3 --------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $True} | Set-CsWebServiceConfiguration -MaxGroupSizeToExpand 400
Dans la commande précédente, la taille de développement de groupe est configurée avec la valeur 400 pour chaque paramètre de configuration des services Web autorisant le développement de groupe. Pour ce faire, on appelle Get-CsWebServiceConfiguration sans aucun paramètre, afin de retourner une collection de tous les paramètres de configuration des services Web utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété EnableGroupExpansion est égale à True. Cette collection filtrée est ensuite envoyée à la cmdlet Set-CsWebServiceConfiguration qui extrait chaque élément de la collection et définit à 400 la valeur de la propriété MaxGroupSizeToExpand.
-------------------------- Exemple 4 ------------------------
Set-CsWebServiceConfiguration -Identity global -ShowDownloadCommunicatorAttendeeLink $True
La commande illustrée dans l’exemple 4 indique comment les paramètres globaux des services Web peuvent être configurés de sorte que toute personne rejoignant une conférence à l’aide d’une application cliente autre que Lync 2010 verra d’abord un lien vers un site lui permettant de télécharger Lync 2010 Attendee. Il faut pour cela inclure le paramètre ShowDownloadCommunicatorAttendeeLink et définir sa valeur sur True.
Voir aussi
Autres ressources
Get-CsWebServiceConfiguration
New-CsWebServiceConfiguration
Remove-CsWebServiceConfiguration