Partager via


Get-CsAVEdgeConfiguration

 

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

Retourne des informations de configuration pour les ordinateurs de votre organisation sur lesquels le service Edge A/V est exécuté. Les paramètres de configuration de ces ordinateurs, également appelés « serveurs Edge A/V », permettent aux utilisateurs internes de partager des données audio et vidéo avec des utilisateurs externes (c’est-à-dire des utilisateurs non connectés à votre réseau interne), ainsi que d’échanger des fichiers et de participer à des sessions de partage du bureau.

Syntaxe

Get-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Description détaillée

Un serveur Edge A/V permet d’échanger du trafic audio et vidéo au travers du pare-feu d’une organisation. Ceci permet notamment à des utilisateurs d’exploiter Microsoft Lync Server 2010 sur Internet, puis d’échanger des données audio et vidéo avec des utilisateurs qui se sont connectés au système à l’intérieur du pare-feu. Les paramètre de configuration du serveur Edge peuvent être affectés au niveau de l’étendue globale, de l’étendue Site et de l’étendue Service. Les paramètres de configuration Edge A/V permettent aux administrateurs de réaliser diverses opérations, notamment de gérer le temps de validité d’une authentification utilisateur avant de devoir la renouveler et de restreindre la bande passante disponible pour un seul utilisateur ou un seul port.

La cmdlet Get-CsAVEdgeConfiguration permet de retourner des informations concernant les paramètres de configuration Edge A/V actuellement appliqués dans votre organisation.

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-CsAVEdgeConfiguration : 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-CsAVEdgeConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique pour la collection de paramètres de configuration Edge A/V que vous souhaitez récupérer. Pour récupérer la collection globale, utilisez la syntaxe suivante : -Identity global. Pour récupérer une collection au niveau de l’étendue Site, utilisez une syntaxe de type : -Identity site:Redmond. Les paramètres configurés au niveau de l’étendue Service doivent être appelés à l’aide d’une syntaxe de type  -Identity service:EdgeServer:atl-cs-001.litwareinc.com. Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez le paramètre Identity d’une stratégie.

Si ce paramètre n’est pas inclus, la cmdlet Get-CsAVEdgeConfiguration retourne une collection de tous les paramètres de configuration Edge A/V en cours d’utilisation dans votre organisation.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lorsque vous précisez les paramètres de configuration Edge A/V à retourner. Par exemple, pour retourner tous les paramètres configurés au niveau de l’étendue Site, utilisez la syntaxe suivante : -Filter site:*. Pour retourner une collection de tous les paramètres configurés au niveau de l’étendue Service, utilisez la syntaxe suivante : -Filter "service:*".

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de configuration Edge A/V à partir du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit.

Types d’entrées

Aucun. Get-CsAVEdgeConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsAVEdgeConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemple

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

Get-CsAVEdgeConfiguration

La commande présentée dans l’exemple 1 retourne une collection de tous les paramètres de configuration Edge A/V configurés pour être utilisés dans l’organisation. Si vous appelez la cmdlet Get-CsAVEdgeConfiguration sans aucun paramètre supplémentaire, le système retourne une collection complète des paramètres de configuration Edge A/V.

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

Get-CsAVEdgeConfiguration -Identity site:Redmond

Dans l’exemple 2, une collection unique de paramètres de configuration Edge A/V est retournée : la collection dont le paramètre Identity est site:Redmond.

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

Get-CsAVEdgeConfiguration -Filter "site:*"

La commande ci-dessus retourne une collection de tous les paramètres de configuration Edge A/V qui ont été configurés au niveau de l’étendue Site. Pour ce faire, la cmdlet Get-CsAVEdgeConfiguration est appelée avec le paramètre Filter ; la valeur de filtre "site:*" limite les données retournées aux paramètres dont le paramètre Identity commence par les caractères "site:". Par définition, ceci limite les données retournées aux paramètres configurés au niveau de l’étendue Site.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -gt 10000}

Dans l’exemple 4, les seuls paramètres de configuration Edge A/V qui sont retournés sont ceux dont la propriété MaxBandwidthPerUserKB est supérieure à 10 000 kilobits par seconde. Pour cela, la commande appelle d’abord la cmdlet Get-CsAVEdgeConfiguration, sans aucun paramètre, qui retourne une collection de tous les paramètres de configuration Edge A/V actuellement utilisés. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété MaxBandwidthPerUserKB est supérieure à 10 000 kilobits par seconde.

-------------------------- Exemple 5 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -eq 10000}

L’exemple 5 présente une commande similaire à celle dévoilée dans l’exemple 4 mais, à la différence de cette dernière, les seuls paramètres Edge A/V retournés ici sont ceux dont la propriété MaxBandwidthPerUserKB est exactement égale à 10 000 kilobits par seconde.

-------------------------- Exemple 6 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxTokenLifetime -lt "08:00:00"}

La commande présentée dans l’exemple 6 ne retourne que les paramètres de configuration Edge A/V dont la propriété MaxTokenLifetime est inférieure à 8 h 00 (08 heures : 00 minute : 00 seconde). La commande appelle d’abord la cmdlet Get-CsAVEdgeConfiguration sans aucun paramètre afin de retourner une collection de tous les paramètres de configuration Edge A/V en cours d’utilisation dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété MaxTokenLifetime est inférieure à 8 h 00 (08:00:00).