Remove-CsNetworkRegion
Dernière rubrique modifiée : 2012-03-25
Supprime la région du réseau existant. Les régions de réseau sont des concentrateurs de réseau ou les routeurs principaux d’un réseau d’entreprise.
Syntaxe
Remove-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Une région réseau interconnecte diverses parties d’un réseau sur plusieurs zones géographiques. Chaque région réseau doit être associée à un site central. Le site central est le site du centre de données sur lequel est exécuté le service de stratégie de bande passante. Utiliser cette cmdlet pour supprimer une région de réseau.
Il est à noter qu’une région de réseau ne peut pas être supprimée si elle est associée à un site réseau (en d’autres termes, l’identité NetworkRegionID de tout site égal à l’identité de la région). Si vous essayez de supprimer une région associée à un site, vous recevrez un message d’erreur.
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-CsNetworkRegion : 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-CsNetworkRegion"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsGlobalRelativeIdentity |
L’identificateur unique de la région de réseau que vous souhaitez supprimer. L’identité sera sous la forme d’une chaîne qui identifie cette région de manière unique. |
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.NetworkRegionType. Accepte la saisie de données transmises via le pipeline pour les objets de région réseau.
Types de retours
Cette cmdlet ne retourne aucune valeur. Elle supprime un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsNetworkRegion -Identity NorthAmerica
L’exemple 1 récupère les régions de réseau avec l’identité NorthAmerica. Puisque les identités sont uniques, cette commande récupère au plus une région de réseau.
-------------------------- Exemple 2 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"} | Remove-CsNetworkRegion
Cet exemple récupère toutes les régions du réseau associées au site central de Redmond. La commande commence par appeler la cmdlet Get-CsNetworkRegion, sans paramètre, afin de récupérer la collection de toutes les régions réseau du déploiement de Microsoft Lync Server 2010. Cette collection est redirigée vers la cmdlet Where-Object. Where-Object filtre cette collection pour ne retourner que les éléments (régions réseau) où la valeur CentralSite est égale à (-eq) site:Redmond. Une fois que vous avez restreint le choix de cette collection à quelques éléments, cette nouvelle collection est redirigée vers Remove-CsNetworkRegion, qui supprime chaque élément dans la collection.
-------------------------- Exemple 3 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"} | Set-CsNetworkSite -NetworkRegionID $null -BypassID $null
Remove-CsNetworkRegion -Identity "NorthAmerica"
L’exemple récupère les régions de réseau avec l’identité NorthAmerica. Cependant, une région ne peut pas être supprimée si elle est associée à un site. Ainsi, cet exemple supprime d’abord toute association entre la région NorthAmerica et le site.
La commande commence par appeler la cmdlet Get-CsNetworkSite, sans paramètre, afin de récupérer la collection de tous les sites de réseau pour le déploiement de Lync Server. Cette collection est redirigée vers la cmdlet Where-Object. Where-Object filtre cette collection pour ne retourner que les éléments (sites de réseau) où la valeur NetworkRegionID est égale à (-eq) NorthAmerica. Une fois le choix de cette collection restreint à ces éléments, cette nouvelle collection est redirigée vers Set-CsNetworkSite. Pour chaque site dont l’identité NetworkRegionID contient NorthAmerica, vous définissons la valeur NetworkRegionID sur Null ($null). Cela supprime la référence à la région sur ce site. Cependant, l’ID de bipasse ne peut pas être associée à un site, s’il n’y en a pas. Ainsi, en plus de supprimer la référence à cette région en configurant l’identité NetworkRegionID sur Null, nous devons également supprimer l’association du bipasse en fixant la valeur BypassID à Null.
Une fois la ligne 1 complétée, tout site associé à la région NorthAmerica n’est plus relié à la région ou aux paramètres de contournement. À ce stade, nous appelons la ligne 2, qui supprime la région de réseau.