Get-CsNetworkSubnet
Dernière rubrique modifiée : 2012-03-23
Récupère des informations sur un ou plusieurs sous-réseaux.
Syntaxe
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Chaque sous-réseau doit être associé à un site réseau afin de déterminer l’emplacement géographique de l’hôte appartenant à ce sous-réseau. Utilisez cette cmdlet pour extraire des informations sur le sous-réseau, y compris la valeur Identity (ID de sous-réseau), le nombre de bits de masque, le site réseau associé et la description du sous-réseau.
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-CsNetworkSubnet : 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-CsNetworkSubnet"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsGlobalRelativeIdentity |
ID de sous-réseau unique du sous-réseau à extraire. Cette valeur sera une adresse IP (par ex., 174.11.12.0). |
Filter |
Facultatif |
Chaîne |
Utilisez ce paramètre pour soumettre tous les sous-réseaux à une recherche par caractères génériques portant sur la valeur Identity. Par exemple, la valeur 172.11.* récupérera tous les sous-réseaux avec une valeur Identity commençant par 172.11. (par exemple, 172.11.10.0, 172.11.25.0, etc.). |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de sous-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
Retourne un ou plusieurs objets de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsNetworkSubnet
Cet exemple extrait tous les sous-réseaux intervenant dans le déploiement de Microsoft Lync Server 2010.
-------------------------- Exemple 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
Cet exemple extrait toutes les informations sur le sous-réseau avec la valeur Identity (ID de sous-réseau) 172.11.15.0.
-------------------------- Exemple 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
Cet exemple extrait tous les sous-réseaux dont les identités commencent par 172.11.
-------------------------- Exemple 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
Cet exemple extrait tous les sous-réseaux associés au site Vancouver. Nous appelons d’abord la cmdlet Get-CsNetworkSubnet sans paramètres, ce qui revient, comme le démontre l’exemple 2, à extraire tous les sous-réseaux définis. Vous redirigeons ensuite cette collection de sous-réseaux vers la cmdlet Where-Object. Where-Object restreint cette collection aux seuls sous-réseaux dont un NetworkSiteID est égal à (-eq) Vancouver.