Partager via


Get-CsNetworkInterSitePolicy

 

Dernière rubrique modifiée : 2012-03-23

Récupère une ou plusieurs stratégies intersites de réseau définissant les restrictions de bande passante entre des sites directement liés au sein d’une configuration de contrôle d’admission des appels (Call Admission Control ou CAC).

Syntaxe

Get-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkInterSitePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Quand des sites réseau partagent un lien direct, des restrictions de bande passante pour les connexions audio et vidéo peuvent être définies pour lesdits sites. Cette cmdlet récupère une ou plusieurs stratégies de site réseau associant des paramètres de restriction de bande passante à deux sites directement connectés.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsNetworkInterSitePolicy : RTCUniversalUserAdmins, 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 "Get-CsNetworkInterSitePolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

Identificateur unique de la stratégie de site réseau que vous souhaitez récupérer. Les stratégies de site réseau étant créées au niveau de l’étendue globale seulement, il n’est pas nécessaire de spécifier une étendue pour cet identificateur. Il contient en effet une chaîne au nom unique permettant d’identifier cette stratégie.

Filter

Facultatif

Chaîne

Chaîne contenant des caractères génériques recherchant les stratégies dont les valeurs d’identité correspondent à la chaîne à caractère générique.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les informations de stratégie intersite réseau à partir du réplica local du magasin central de gestion, au lieu du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Récupère un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType.

Exemple

-------------------------- Exemple 1 --------------------------

Get-CsNetworkInterSitePolicy

Le fait d’appeler Get-CsNetworkInterSitePolicy sans paramètres récupère toutes les stratégies de site réseau définies entre deux sites réseau directement liés.

-------------------------- Exemple 2 --------------------------

Get-CsNetworkInterSitePolicy -Identity Reno_Portland

Cet exemple récupère la stratégie de site réseau ayant l’identité Reno_Portland.

-------------------------- Exemple 3 --------------------------

Get-CsNetworkInterSitePolicy -Filter *Reno*

L’exemple 3 récupère toutes les stratégies de site réseau contenant la chaîne Reno n’importe où au sein de la valeur Identity. Les caractères génériques (*) au sein de la valeur transmise au paramètre Filter signifie « tout caractère ou jeu de caractères. » En d’autres termes, la chaîne *Reno* fait correspondre des valeurs d’identité correspondant à un ou plusieurs caractères, suivi de la chaîne Reno et d’un ou plusieurs caractères.

-------------------------- Exemple 4 --------------------------

Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}

Cet exemple récupère toutes les stratégies de site réseau qui n’ont pas de profil de stratégie de bande passante. La commande commence par appeler Get-CsNetworkInterSitePolicy qui, comme dans l’exemple 1, récupère une collection de toutes les stratégies de site réseau. Cette collection est ensuite redirigée vers la cmdlet Where-Object. Where-Object restreint la collection aux stratégies de site réseau qui n’ont pas de profil de stratégie de bande passante. Pour ce faire, elle recherche pour chaque stratégie de site la propriété BWPolicyProfileID égale (-eq) à Null ($null).