Get-CsNetworkSite
Dernière rubrique modifiée : 2012-03-23
Extrait un ou plusieurs sites de réseau définis pour le service Contrôle d’admission des appels ou le système Enhanced 9-1-1 (E9-1-1).
Syntaxe
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Les sites de réseau sont les bureaux ou emplacements configurés au sein de chaque région d’un contrôle d’admission des appels (Call Admission Control ou CAC) ou encore d’un déploiement E9-1-1. Cette cmdlet récupère les paramètres d’un ou plusieurs sites existants.
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-CsNetworkSite : 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-CsNetworkSite"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsGlobalRelativeIdentity |
Identificateur unique du site de réseau que vous souhaitez récupérer. Les sites n’étant créés qu’au niveau de l’étendue globale, il n’est pas nécessaire de spécifier une étendue. Vous ne devez spécifier que l’ID de site. (Notez qu’il s’agit de la même valeur que NetworkSiteID pour le site de réseau.) |
Filter |
Facultatif |
Chaîne |
Chaîne à caractère générique permettant de récupérer plusieurs sites en fonction de l’identité Site correspondant à la valeur Filter. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de site de réseau à partir du réplica local du magasin central de gestion, et non du magasin central de gestion proprement dit. |
Types d’entrées
Aucun.
Types de retours
Récupère un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsNetworkSite
L’appel de la cmdlet Get-CsNetworkSite sans paramètres retourne tous les sites de réseau configurés pour le contrôle d’admission des appels (CAC) ou le système E9-1-1 au sein du déploiement de Microsoft Lync Server 2010
-------------------------- Exemple 2 --------------------------
Get-CsNetworkSite -Identity Redmond
Cette commande récupère le site dont l’identité (et par définition NetworkSiteID) est Redmond.
-------------------------- Exemple 3 --------------------------
Get-CsNetworkSite -Filter NA*
La commande de l’exemple 3 appelle Get-CsNetworkSite avec le paramètre Filter. La valeur du paramètre Filter est NA*, ce qui signifie que cette commande récupère tous les sites dont l’identité commence par la chaîne NA et est suivie d’une certain nombre de caractères. Les sites retournés sont par exemple NARedmond, NAVancouver ou NAChicago.
-------------------------- Exemple 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
L’exemple 4 utilise deux cmdlets, Get-CsNetworkSite etWhere-Object, pour récupérer tous les sites faisant partie de la région NorthAmerica. La commande commence par appeler Get-CsNetworkSite sans aucun paramètre afin de récupérer tous les sites de réseau. Cette collection de sites est ensuite redirigée vers Where-Object qui filtre la collection, en cherchant tous les sites de la collection pour lesquels la propriété NetworkRegionID est égale (-eq) à NorthAmerica.