Partager via

  • Article

New-CsNetworkSubnet

 

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

Crée un nouveau sous-réseau.

Syntaxe

New-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> -MaskBits <Int32> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkSubnet -MaskBits <Int32> -SubnetID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<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 créer un nouveau sous-réseau et l’affecter dans le même temps (éventuellement) à un site réseau.

La plupart des déploiements Microsoft Lync Server 2010 qui implémentent le contrôle d’admission des appels (CAC) comptent généralement un nombre important de sous-réseaux. Pour cette raison, il est souvent préférable d’appeler la cmdlet New-CsNetworkSubnet conjointement avec la cmdlet Import-CSV Windows PowerShell. En regroupant ces cmdlets, vous pouvez lire les paramètres de sous-réseau dans un fichier de valeurs séparées par des virgules (CSV) et créer simultanément plusieurs sous-réseaux. Pour plus d’informations sur cette cmdlet, reportez-vous à la section « Exemples ».

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsNetworkSubnet : 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 "New-CsNetworkSubnet"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

ID unique du sous-réseau créé. Ce dernier doit être une adresse IP (telle que 174.11.12.0) et la première adresse de la plage d’adresses IP définie par le sous-réseau.

MaskBits

Obligatoire

Int32

Masque de bits à appliquer au sous-réseau créé.

Valeurs valides : 1 à 32

SubnetID

Obligatoire

Chaîne

Cette valeur est la même que l’identité. Vous devez spécifier une identité ou un ID de sous-réseau, mais pas les deux à la fois. La valeur attribuée à l’un sera automatiquement appliquée à l’autre.

Description

Facultatif

Chaîne

Description du sous-réseau créé.

NetworkSiteID

Facultatif

Chaîne

ID du site auquel ce sous-réseau appartient. Vous pouvez récupérer des ID de site pour votre déploiement en appelant la cmdlet Get-CsNetworkSite.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.

Exemple

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

New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver

Cet exemple explique comment créer un nouvel objet de sous-réseau qui représente le sous-réseau 172.11.15.0/24. L’identité du sous-réseau est définie sur 172.11.15.0. Cette valeur sera automatiquement affectée au paramètre SubnetID. Vous devez définir des masques de bits pour un sous-réseau. Cette opération est effectuée en saisissant une valeur (dans ce cas, 24) pour le paramètre MaskBits. Enfin, l’ID de site ID Vancouver est transmis au paramètre NetworkSiteID pour associer ce sous-réseau à ce site.

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

Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}

L’exemple 2 illustre la lecture d’un fichier CSV pour créer une série de sous-réseaux. Le fichier CSV illustré dans cet exemple se présente comme suit :

Identity, Mask, SiteID

172.11.12.0, 24, Redmond

172.11.13.0, 24, Chicago

172.11.14.0, 25, Vancouver

172.11.15.0, 31, Paris

...

Dans l’exemple, on commence par appeler la cmdlet Import-CSV, en lui transmettant le chemin d’accès à un fichier CSV. Cette cmdlet lit le contenu de ce fichier en mémoire. Ce contenu de fichier est ensuite redirigé vers la fonction foreach. La fonction foreach est répercutée sur chaque ligne du contenu. Comme vous pouvez le voir dans le fichier fourni en exemple, la première ligne est une liste des en-têtes qui définissent le reste du contenu. La fonction foreach utilisera ces en-têtes pour accéder aux valeurs séparées par des virgules en fonction du nom.

La cmdlet New-CsNetworkSubnet est appelée dans l’instruction foreach. À mesure que la fonction foreach est répercutée sur chaque ligne du contenu de fichier, les valeurs de cette ligne sont transmises aux paramètres New-CsNetworkSubnet. Par exemple, la première fois dans l’instruction foreach, la cmdlet New-CsNetworkSubnet crée un sous-réseau comportant l’identité 172.11.12.0 : il s’agit de la valeur de l’identité figurant sur la première ligne de valeurs séparée par des virgules (le signe $_ indique la valeur actuelle de la boucle foreach). La valeur Mask (24) est ensuite transmise au paramètre MaskBits, alors que la valeur SiteID (Redmond) du fichier est transmise au paramètre NetworkSiteID.

Ce processus se poursuit jusqu’à la lecture complète de toutes les lignes du fichier et l’utilisation de leurs valeurs pour créer de nouveaux sous-réseaux.