Partager via


New-CsAVEdgeConfiguration

 

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

Crée une nouvelle collection de paramètres de configuration sur des ordinateurs exécutant le service Edge A/V (ces ordinateurs sont également connus sous le nom de serveurs Edge A/V). Un serveur Edge A/V permet 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).

Syntaxe

New-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<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. Ainsi, les utilisateurs peuvent utiliser Microsoft Lync Server 2010 sur Internet, puis échanger des données audio et vidéo avec des utilisateurs connectés au système à l’intérieur du pare-feu. Les paramètres de configuration d’un serveur Edge peuvent être attribués au niveau de l’étendue globale et des étendues Site et Service. La configuration Edge A/V permet aux administrateurs de gérer la durée pendant laquelle l’authentification des utilisateurs doit rester valide avant de devoir être renouvelée et de restreindre la bande passante utilisable par un seul utilisateur ou un seul port.

La cmdlet New-CsAVEdgeConfiguration vous permet de créer de nouvelles collections de paramètres de configuration de serveur Edge A/V au niveau de l’étendue Site ou de l’étendue Service. Comme indiqué, les paramètres de serveur Edge A/V peuvent également être configurés au niveau de l’étendue globale. Toutefois, vous ne pouvez pas créer de nouvelles collections au niveau de l’étendue globale.

Notez qu’un site ou un service donné peut héberger, au maximum, une seule collection de paramètres de configuration de serveur Edge A/V. Si le site de Redmond héberge déjà une collection de paramètres de serveur Edge A/V, vous ne pouvez pas créer une nouvelle collection dont l’identité est site:Redmond.

Sauf instruction contraire du support technique de Microsoft, nous vous recommandons de ne pas modifier les paramètres de configuration Edge A/V par défaut. De ce fait, vous n’aurez sans doute pas besoin de créer une nouvelle collection de paramètres pour un site ou un service.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la collection de paramètres de configuration Edge A/V à créer. Pour créer une collection de paramètres à appliquer au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. (Notez que cette commande échouera si une collection de paramètres de configuration Edge A/V a déjà été appliquée au site de Redmond.) Les paramètres configurés au niveau de l’étendue Service doivent utiliser une syntaxe du type : -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

MaxBandwidthPerPortKB

Facultatif

Entier

Indique la quantité maximale de bande passante (en kilobits par seconde) qu’il est possible d’allouer à un port unique. Vous pouvez définir la bande passante maximale sur n’importe quelle valeur d’entier comprise entre 1 et 4294967296 (4096 gigabits) ; la valeur par défaut est 3000.

MaxBandwidthPerUserKB

Facultatif

Entier

Indique la quantité maximale de bande passante (en kilobits par seconde) qu’il est possible d’allouer à un utilisateur. Vous pouvez définir la bande passante maximale sur n’importe quelle valeur d’entier comprise entre 1 et 4294967296 (4096 gigabits) ; la valeur par défaut est 10000.

MaxTokenLifetime

Facultatif

Entier

Temps maximal pendant lequel un jeton d’authentification peut être utilisé avant d’arriver à expiration et d’être renouvelé. Les durées de vie des jetons sont exprimées dans le format suivant : Jours.Heures:Minutes:Secondes. Par exemple, une durée de 13 jours s’exprimera comme suit, avec un point (.) suivant le nombre de jours, et des signes deux-points (:) pour séparer les heures, les minutes et les secondes.

13.00:00:00

La valeur de 8 heures adoptée par défaut doit se présenter comme suit :

08:00:00

La durée de vie minimale des jetons est de 1 minute (00:01:00) ; la durée maximale autorisée est de 180 jours (180.00:00:00).

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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. New-CsAVEdgeConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Exemple

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

New-CsAVEdgeConfiguration -Identity site:Redmond -MaxTokenLifetime "04:00:00"

La commande présentée dans l’exemple 1 crée une collection de paramètres de configuration Edge A/V pour le site de Redmond. Dans cet exemple, la propriété MaxTokenLifetime est configurée avec la valeur 4 heures (04 heures : 00 minute : 00 seconde).

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

$x = New-CsAVEdgeConfiguration -Identity site:Redmond -InMemory
$x.MaxTokenLifetime = "04:00:00"
Set-CsAVEdgeConfiguration -Instance $x

L’exemple 2 explique comment vous pouvez créer une nouvelle collection de paramètres de configuration Edge A/V en mémoire, puis transformer ces paramètres virtuels en une collection réelle de paramètres Edge A/V. Pour ce faire, la première commande de l’exemple crée une nouvelle collection de paramètres pour le site de Redmond ; le paramètre InMemory est ajouté pour que ces paramètres soient créés en mémoire uniquement et pour qu’ils ne soient pas immédiatement appliqués au site de Redmond. Étant donné que ces paramètres existent uniquement en mémoire, ils doivent être stockés dans une variable, $x dans ce cas.

Dans la deuxième commande, la valeur de la propriété MaxTokenLifetime est définie à 4 heures (04 heures : 00 minute : 00 seconde). La troisième commande utilise ensuite Set-CsAVEdgeConfiguration pour appliquer les paramètres stockés dans $x au site de Redmond.