Remove-CsNetworkSubnet
Dernière rubrique modifiée : 2012-03-27
Supprime un sous-réseau existant.
Syntaxe
Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 supprimer un 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 Remove-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 "Remove-CsNetworkSubnet"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsGlobalRelativeIdentity |
ID de sous-réseau unique du sous-réseau à supprimer. Cette valeur sera une adresse IP (par ex., 174.11.12.0). |
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 supprime un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsNetworkSubnet -Identity 172.11.15.0
Cet exemple supprime le sous-réseau avec la propriété Identity (ID de sous-réseau) 172.11.15.0.
-------------------------- Exemple 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet
L’exemple 2 supprime tous les sous-réseaux associés au site Vancouver. 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 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 Remove-CsNetworkSubnet qui supprime chaque élément de la collection.