Set-CsNetworkSite
Dernière rubrique modifiée : 2012-03-26
Modifie un site réseau existant qui a été défini pour le contrôle d'admission des appels (CAC) ou pour le système Enhanced 9-1-1 (E9-1-1).
Syntaxe
Set-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les sites de réseau sont les bureaux ou emplacements configurés au sein de chaque région d’un contrôle d’admission des appels (Call Admission Control ou CAC) ou encore d’un déploiement E9-1-1. Cette cmdlet modifie les paramètres sur un site existant. Ces derniers incluent notamment la région à laquelle le site est associé, la description du site et le profil de stratégie de bande passante associé.
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-CsNetworkSite : 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-CsNetworkSite"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsGlobalRelativeIdentity |
Identificateur unique du site réseau que vous souhaitez modifier. Les sites étant uniquement créés dans l’étendue globale, il est inutile de spécifier une étendue. Il suffit de spécifier l’ID du site réseau. |
Instance |
Facultatif |
DisplayNetworkSiteType |
Référence à un objet de site réseau (objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType). Vous pouvez extraire cet objet en appelant la cmdlet Get-CsNetworkSite. |
BWPolicyProfileID |
Facultatif |
Chaîne |
Identité du profil de stratégie de bande passante qui définira les limitations pour ce site. Vous pouvez récupérer une liste des profils disponibles en appelant la cmdlet Get-CsNetworkBandwidthPolicyProfile. Si vous spécifiez une valeur pour ce paramètre, vous devez également saisir une valeur pour le paramètre NetworkRegionID. |
BypassID |
Facultatif |
Chaîne |
Identificateur global unique (GUID). Ce GUID est utilisé pour mapper des sites réseau à des paramètres de déviation du trafic multimédia au sein d’une configuration réseau CAC ou E9-1-1 (Utilisez cette valeur BypassID au moment d’appeler la cmdlet New-CsNetworkMediaBypassConfiguration). Si vous spécifiez une valeur pour ce paramètre, vous devez également saisir une valeur pour le paramètre NetworkRegionID. Si vous spécifiez une valeur pour le paramètre NetworkRegionID mais pas pour ce paramètre, une valeur BypassID sera automatiquement générée. Si vous spécifiez explicitement une valeur, elle doit être au format d’un GUID (par exemple : 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Il est recommandé de saisir une valeur pour le paramètre NetworkRegionID et d’autoriser la génération automatique de la valeur BypassID. Si vous entrez une valeur manuellement, vous recevrez une invitation à confirmer que vous ne voulez pas que la valeur soit générée automatiquement. |
Description |
Facultatif |
Chaîne |
Chaîne décrivant le site. Vous pouvez utiliser ce paramètre pour fournir une description plus explicite de l’objectif et de l’emplacement du site qui peut être exprimé par l’identité seule. |
LocationPolicy |
Facultatif |
Chaîne |
Nom de la stratégie d’emplacement associée à ce site. La stratégie d’emplacement assigne des paramètres E9-1-1 spécifiques au site. Vous pouvez récupérer une liste de stratégies d’emplacement en appelant la cmdlet Get-CsLocationPolicy. |
NetworkRegionID |
Facultatif |
Chaîne |
Identité de la région réseau à laquelle ce site est associé. Ce paramètre doit contenir une valeur si vous souhaitez spécifier une valeur BypassID (soit via un processus de génération automatique, soit manuellement) ou si la propriété EnableBandwidthPolicyCheck de la configuration du réseau est True. Vous pouvez récupérer les paramètres de configuration du réseau en appelant la cmdlet Get-CsNetworkConfiguration. Si une valeur BypassID existe déjà sur ce site et que vous ne spécifiez aucune valeur pour le paramètre BypassID, il sera remplacé par un paramètre BypassID automatiquement généré. |
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.DisplayNetworkSiteType. Accepte la saisie de données transmises via le pipeline pour les objets de site réseau.
Types de retours
Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
Dans cet exemple, le site réseau appelé Vancouver est modifié. Le nom du site modifié est spécifié en tant que valeur du paramètre Identity. Le site de Vancouver est déplacé vers une nouvelle région, qui requiert la modification du paramètre NetworkRegionID, dans ce cas, la région nommée Canada. Parce que le paramètre NetworkRegionID a été fourni, mais qu’aucune valeur n’a été spécifiée pour le paramètre BypassID, une valeur sera automatiquement générée. Tout ID de dérivation précédemment existant sera remplacé.
-------------------------- Exemple 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
L’exemple 2 illustre simplement le profil de stratégie de bande passante associé au site de Vancouver. Le nom de site est spécifié en tant que valeur du paramètre Identity. Nous spécifions ensuite une valeur pour le paramètre BWPolicyProfileID : LowBWLimits. Les stratégies associées à ce profil seront utilisées pour ce site.