Get-CsAccessEdgeConfiguration
Dernière rubrique modifiée : 2012-03-23
Retourne les informations relatives aux paramètres de configuration pour les ordinateurs exécutant service Edge d’accès dans votre organisation (également appelés serveurs Edge d’accès). Les serveurs Access Edge permettent aux utilisateurs externes à votre réseau de communiquer avec les utilisateurs de votre réseau interne.
Syntaxe
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Les serveurs Edge d’accès (également connus sous le nom de serveurs proxy) vous permettent de mettre vos capacités Microsoft Lync Server 2010 à la disposition des personnes qui ne sont pas connectées à votre réseau interne. Par exemple, si des utilisateurs distants ou authentifiés ouvrent une session Lync Server 2010 sur Internet plutôt que sur votre réseau interne, vous devez configurer un serveur Edge d’accès. Par ailleurs, les serveurs Edge sont indispensables si vous voulez vous fédérer à une autre organisation ou donner à vos utilisateurs le droit de communiquer avec des personnes dont le compte de messagerie instantanée est un compte public comme en proposent Yahoo!, AOL ou MSN. Les serveurs Edge d’accès sont en position sur le réseau de périmètre et sont utilisés pour réaliser et valider les connexions entre les utilisateurs qui se trouvent à l’intérieur et à l’extérieur de votre réseau interne.
Sous Lync Server, les serveurs Edge d’accès se gèrent à l’aide d’une collection simple et globale de paramètres de configuration. La cmdlet Get-CsAccessEdgeConfiguration vous permet de retourner les informations relatives à ces paramètres globaux. Notez que les valeurs de la propriété renvoyées par Get-CsAccessEdgeConfiguration varieront en fonction du type de routage configuré pour vos serveurs Edge. Pour plus d’informations, consultez la rubrique d’aide Set-CsAccessEdgeConfiguration.
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-CsAccessEdgeConfiguration : 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-CsAccessEdgeConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique des paramètres de configuration du serveur Edge d’accès à retourner. Puisque vous ne pouvez avoir qu’une seule instance unique et globale de ces paramètres, Il n’est pas nécessaire d’inclure l’identité pour appeler Get-CsAccessEdgeConfiguration. Vous pouvez toutefois utiliser la syntaxe suivante pour extraire les paramètres globaux : -Identity global. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques afin de spécifier les paramètres de configuration de serveur Edge d’accès à retourner. Puisque vous ne pouvez avoir qu’une seule instance unique et globale de ces paramètres, il n’y a pas vraiment lieu d’utiliser le paramètre Filter. Cependant, si vous voulez, vous pouvez utiliser la syntaxe suivante pour récupérer les paramètres globaux : -Identity "g*". |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de configuration du serveur Edge d’accès du réplica local de la magasin central de gestion et non de la magasin central de gestion proprement dite. |
Types d’entrées
Aucun. Get-CsAccessEdgeConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsAccessEdgeConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting ou de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsAccessEdgeConfiguration
L’exemple 1 illustre une utilisation simple de Get-CsAccessEdgeConfiguration : appeler la cmdlet sans autres paramètres retourne les valeurs de propriété nécessaires à l’implémentation de votre serveur Edge d’accès. Notez qu’il n’est pas nécessaire d’inclure les paramètres Identity ou Filter parce qu’il n’y a qu’un groupe de données de configuration du serveur Edge d’accès.
-------------------------- Exemple 2 --------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
La commande précédente ne retourne que trois valeurs de propriété pour configurer votre serveur Edge d’accès : AllowAnonymousUsers, AllowFederatedUsers et AllowOutsideUsers. Pour ce faire, cette commande utilise d’abord Get-CsAccessEdgeConfiguration pour retourner les valeurs de propriété du serveur Edge d’accès. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui ne choisit que les propriétés commençant par la valeur de chaîne « Allow ». De même, seules ces valeurs seront affichées à l’écran.
-------------------------- Exemple 3 --------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
La commande indiquée à l’exemple 3 retourne une valeur unique pour la propriété de configuration du serveur Edge d’accès : EnablePartnerDiscovery. Pour ce faire, Get-CsAccessEdgeConfiguration est appelée en premier afin de retourner toutes les valeurs de propriété de configuration de serveur Edge d’accès. Cet appel à Get-CsAccessEdgeConfiguration est mis entre parenthèses. Cela garantit que cette commande sera menée à bien par Windows PowerShell avant toute chose. Une fois toutes les valeurs de propriété retournées, c’est la méthode de « notation par points » standard (le nom de l’objet suivi d’un point, puis du nom de la propriété) qui est utilisée pour afficher la valeur d’une seul propriété : EnablePartnerDiscovery.