Set-CsNetworkSubnet
Dernière rubrique modifiée : 2012-03-26
Modifie un sous-réseau existant.
Syntaxe
Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSubnet [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaskBits <Int32>] [-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 modifier le site réseau associé, changer la description du sous-réseau ou modifier les masques de bits 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 Set-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 "Set-CsNetworkSubnet"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsGlobalRelativeIdentity |
ID de sous-réseau unique du sous-réseau à modifier. Cette valeur sera soit une adresse IP (comme par exemple 174.11.12.0), soit une URL commençant par http: or https:. |
Instance |
Facultatif |
SubnetType |
Référence à un objet de sous-réseau à modifier. Cet objet doit être du type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType, qui peut être récupéré par la cmdlet Get-CsNetworkSubnet. |
Description |
Facultatif |
Chaîne |
Description du sous-réseau en cours de modification. |
MaskBits |
Facultatif |
Int32 |
Masque de bits à appliquer au sous-réseau. |
NetworkSiteID |
Facultatif |
Chaîne |
ID du site réseau auquel ce sous-réseau doit être appliqué. 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. |
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.NetworkConfiguration.SubnetType. Accepte la saisie de données transmises via le pipeline pour les objets de sous-réseau.
Types de retours
Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
Cet exemple modifie le sous-réseau, avec la propriété Identity (ID de sous-réseau) 172.11.15.0. Le sous-réseau est modifié, avec une nouvelle valeur pour MaskBits (25) et une nouvelle valeur pour NetworkSiteID (Chicago).
-------------------------- Exemple 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
L’exemple 2 déplace tous les sous-réseaux du site Vancouver vers le site Chicago. Pour cela, nous commençons par appeler la cmdlet Get-CsNetworkSubnet. Cet appel permet de récupérer une collection de tous les sous-réseaux définis au sein du déploiement de Microsoft Lync Server 2010. Cette collection de sous-réseaux est ensuite redirigée vers la cmdlet Where-Object. Where-Object restreint cette collection aux seuls sous-réseaux dont un NetworkSiteID est égal à (-eq) Vancouver. À présent que la collection ne contient plus que les sous-réseaux associés au site Vancouver, nous la redirigeons vers Set-CsNetworkSubnet. Nous fournissons un paramètre à Set-CsNetworkSubnet : NetworkSiteID. En transmettant au paramètre la valeur Chicago, nous indiquons à Set-CsNetworkSubnet de changer l’ID de site réseau de chaque membre de la collection à Chicago.