Set-CsAVEdgeConfiguration
Dernière rubrique modifiée : 2012-03-26
Permet de modifier les 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), ainsi que d’échanger des fichiers et de participer à des sessions de partage du bureau.
Syntaxe
Set-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsAVEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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. Cette configuration permet aux administrateurs de gérer, entre autres, 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.
Grâce à la cmdlet Set-CsAVEdgeConfiguration, vous pouvez modifier les paramètres de configuration Edge A/V actuellement utilisés dans votre organisation. Toutefois, sauf instruction contraire du support technique de Microsoft, il est recommandé aux administrateurs de ne pas modifier les paramètres A/V par défaut.
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-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 "Set-CsAVEdgeConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique de la collection des paramètres de configuration Edge A/V à modifier. Pour modifier la collection globale, utilisez la syntaxe suivante : -Identity global. Pour modifier une collection de sites, utilisez une syntaxe similaire à ce qui suit : -Identity site:Redmond. Les paramètres configurés au niveau de l’étendue Service doivent être appelés suivant une syntaxe similaire à celle-ci : -Identity service:EdgeServer:atl-cs-001.litwareinc.com. |
Instance |
Facultatif |
Objet MediaRelaySettings |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
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 |
TimeSpan |
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. |
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.Edge.MediaRelaySettings. Set-CsAVEdgeConfiguration accepte la saisie de données transmises via le pipeline pour l’objet de configuration du relais multimédia.
Types de retours
Set-CsAVEdgeConfiguration ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsAVEdgeConfiguration -Identity global -MaxTokenLifetime "04:00:00"
Dans l’exemple 1, la commande modifie la propriété MaxTokenLifetime pour les paramètres de configuration Edge A/V globaux. Dans cet exemple, la durée de vie maximale du jeton est définie à 4 heures (04 heures : 00 minute : 00 seconde).
Voir aussi
Autres ressources
Get-CsAVEdgeConfiguration
New-CsAVEdgeConfiguration
Remove-CsAVEdgeConfiguration