New-CsNetworkSite
Dernière rubrique modifiée : 2012-03-27
Crée un site de réseau à utiliser avec le contrôle d’admission des appels (CAC) ou Enhanced 9-1-1 (E9-1-1).
Syntaxe
New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSite -NetworkRegionID <String> -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <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 crée un nouveau site et l’associe à une région. Par exemple, un site de réseau pour l’Amérique du Nord pourra être associé à des sites de réseau tels que Chicago, Redmond et Vancouver. Un site de réseau CAC doit être créé pour chaque site dans l’organisation, même s’il n’y a pas restrictions de bande passante pour ce site.
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-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 "New-CsNetworkSite"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsGlobalRelativeIdentity |
Identificateur unique du site de réseau nouvellement créé. Les sites étant créées au niveau de l’étendue globale seulement, il n’est pas nécessaire de spécifier une étendue pour cet identificateur. Au lieu de cela, il contient une chaîne qui est unique parmi tous les sites de réseau dans le déploiement Microsoft Lync Server 2010. |
NetworkRegionID |
Obligatoire |
Chaîne |
Identité de la région de réseau à laquelle ce site est associé. Ce paramètre doit contenir une valeur si vous voulez fournir une identité Bypass ID (procédure automatique ou manuelle) ou lorsque la propriété EnableBandwidthPolicyCheck de configuration du réseau a la valeur True. Vous pouvez récupérer les paramètres de configuration du réseau en appelant la cmdlet Get-CsNetworkConfiguration. |
NetworkSiteID |
Obligatoire |
Chaîne |
Cette valeur est la même que l’identité. Vous ne pouvez pas spécifier à la fois une identité et une valeur NetworkSiteID. La valeur entrée pour l’un est automatiquement utilisée pour l’autre. |
BWPolicyProfileID |
Facultatif |
Chaîne |
Identité du profil de stratégie de bande passante qui définit les restrictions de bande passante de 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 spécifier une valeur pour le paramètre NetworkRegionID. |
BypassID |
Facultatif |
Chaîne |
Identificateur global unique (GUID). Ce GUID est utilisé pour mapper des sites de 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 ne spécifiez pas la valeur de ce paramètre, une valeur sera automatiquement générée, mais uniquement si vous fournissez une valeur pour le paramètre NetworkRegionID. Si vous ne fournissez pas de paramètre NetworkRegionID, aucune identité de contournement BypassID ne pourra être générée. Vous ne pouvez pas non plus fournir de valeur spécifique pour le paramètre BypassID sans également fournir une valeur pour le paramètre NetworkRegionID. Si vous spécifiez explicitement une valeur, elle doit l’être au format d’un GUID (par exemple, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Une procédure de création automatique est recommandée. Si vous entrez une valeur manuellement, vous recevrez une invitation à confirmer que vous ne voulez pas générer automatiquement une valeur. |
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 du site qui peut être exprimé par l’identité seule. |
LocationPolicy |
Facultatif |
Chaîne |
Nom de la stratégie d’emplacement associée au 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. |
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.DisplayNetworkSiteType.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica
Dans cet exemple, un nouveau site de réseau du nom de Vancouver est créé. Le nom du site est spécifié en tant que valeur du paramètre d’identité. Une valeur est également spécifiée pour le paramètre NetworkRegionID qui associe le site à la région (dans cet exemple NorthAmerica). Une valeur BypassID est automatiquement générée. Le paramétrage manuel d’une valeur pour BypassID n’est pas recommandé.
Remarquez que la commande de cet exemple n’inclut pas le paramètre BWPolicyProfileID. À moins qu’une valeur soit ajoutée à ce site à l’aide de Set-CsNetworkSite, ce site n’aura aucune limite de bande passante pour les connexions média.
-------------------------- Exemple 2 --------------------------
New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA -BWPolicyProfileID LowBWLimits
Dans l’exemple 2, nous créons un nouveau site de réseau appelé Paris. Le nom du site est spécifié en tant que valeur du paramètre d’identité. Comme dans l’exemple 1, nous spécifiions également une valeur pour l’identité NetworkRegionID ; cette fois-ci, il s’agit de la région EMEA. Une fois encore, nous suivons le chemin recommandé en autorisant la cmdlet à générer une identité BypassID. Contrairement à l’exemple 1, cet exemple spécifie aussi une valeur pour le paramètre BWPolicyProfileID : LowBWLimits. Les stratégies associées à ce profil seront utilisées pour ce site.