• Article

Set-CsConferencingConfiguration

 

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

Modifie une collection existante de paramètres de configuration de conférence. Les paramètres de conférence déterminent des caractéristiques telles que la taille maximale autorisée pour le contenu des réunions et des documents. Ils définissent aussi la période de grâce du contenu (c'est-à-dire, le temps pendant lequel le contenu est stocké avant d'être supprimé) et les URL pour les téléchargements internes et externes du client pris en charge.

Syntaxe

Set-CsConferencingConfiguration [-Identity <XdsIdentity>] [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]

Set-CsConferencingConfiguration [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-Instance <PSObject>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour les conférences, la gestion et l’administration sont divisées entre deux ensembles de cmdlets. Si vous souhaitez gérer les choses que les utilisateurs peuvent et ne peuvent pas faire (par exemple, pouvoir inviter des participants anonymes à se joindre à une conférence, être autorisés à proposer le partage d’application et/ou le transfert de fichiers lors d’une conférence), vous devez alors utiliser les cmdlets CsConferencingPolicy.

Outre la gestion des activités des utilisateurs, les administrateurs doivent également s'occuper de la gestion du service de conférence Web. Par exemple, les administrateurs doivent être en mesure, entre autres, de spécifier la quantité maximale de stockage de contenu attribuée à une conférence particulière et préciser la période de grâce avant que le contenu de la conférence soit automatiquement supprimé. Ils doivent également être en mesure de spécifier les ports utilisés pour des activités, telles que le partage d’application et les transferts de fichiers.

Ces dernières activités peuvent être gérées au moyen des cmdlets CsConferencingConfiguration. Ces cmdlets vous permettent de gérer les serveurs eux-mêmes. Les cmdlets CsConferencingConfiguration (qui peuvent être appliquées au niveau de l’étendue globale et des étendues Site et Service) ne sont pas utilisées pour spécifier si un utilisateur peut ou non partager des applications lors d’une conférence ; si le partage d’application est autorisé, toutefois, ces cmdlets vous permettent d’indiquer quels ports sont à utiliser pour cette activité. De même, les cmdlets vous permettent de spécifier, entre autres, les limites de stockage et les délais d’expiration, ainsi que des pointeurs vers des URL internes et externes où les utilisateurs peuvent obtenir de l’aide et des ressources ayant trait aux conférences.

Lorsque vous installez Microsoft Lync Server 2010, le système vous fournit une collection unique de paramètres de configuration de conférence (collection globale). Si vous souhaitez créer des paramètres personnalisés pour un site ou un service, utilisez la cmdlet New-CsConferencingConfiguration. Une fois ces paramètres personnalisés créés, vous pouvez les modifier individuellement (ou modifier la collection globale) via la cmdlet Set-CsConferencingConfiguration.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la collection de paramètres de configuration de conférence à modifier. Pour spécifier la collection globale, utilisez la syntaxe suivante : -Identity global. Pour spécifier une collection configurée dans l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Pour spécifier une collection configurée dans l’étendue Service, utilisez une syntaxe similaire à celle-ci : -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com". Le service de conférence Web est le seul qui peut héberger ces paramètres de configuration.

Si vous ne définissez pas ce paramètre, Set-CsConferencingConfiguration modifiera automatiquement les paramètres globaux.

Instance

Facultatif

Objet ConfSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

ClientAppSharingPort

Facultatif

Entier

Représente le numéro de port de début utilisé pour le partage d’application. ClientAppSharingPort doit être un numéro de port compris entre 1024 et 65535, inclus. La valeur par défaut est 5350.

ClientAppSharingPortRange

Facultatif

Entier

Indique le nombre total de ports disponibles pour le partage d’application. (La valeur par défaut est 40.) Pour déterminer les ports utilisés pour le partage d’application, utilisez cette valeur et la valeur ClientAppSharingPort. Par exemple, si ClientAppSharingPort est défini à 5350 et ClientAppSharingPortRange est défini à 3, les 3 ports suivants sont disponibles pour le partage d’application : 5350; 5351; 5352.

ClientAudioPort

Facultatif

Entier

Représente le numéro de port de début utilisé pour l’audio client. ClientAudioPort doit être un numéro de port compris entre 1024 et 65535, inclus. La valeur par défaut est 5350.

ClientAudioPortRange

Facultatif

Entier

Indique le nombre total de ports disponibles pour l'audio client. (La valeur par défaut est 40.) Pour déterminer les ports utilisés pour l’audio client, utilisez cette valeur et la valeur ClientAudioPort. Par exemple, si ClientAudioPort est défini à 5350 et ClientAudioPortRange est défini à 3, les trois ports suivants sont disponibles pour l'audio client : 5350; 5351; 5352.

ClientFileTransferPort

Facultatif

Entier

Représente le numéro de port de début utilisé pour les transferts de fichiers. ClientFileTransferPort doit être un numéro de port compris entre 1024 et 65535, inclus. La valeur par défaut est 5350.

ClientFileTransferPortRange

Facultatif

Entier

Indique le nombre total de ports disponibles pour les transferts de fichiers. (La valeur par défaut est 40.) Pour déterminer les ports utilisés pour les transferts de fichiers, utilisez cette valeur et la valeur ClientFileTransferPort. Par exemple, si ClientFileTransferPort est défini à 5350 et ClientFileTransferPortRange est défini à 3, les trois ports suivants sont disponibles pour les transferts de fichiers : 5350; 5351; 5352.

ClientMediaPort

Facultatif

Entier

Représente le numéro de port de début utilisé pour le média client. Utilisez ce paramètre pour des clients Microsoft Office Communicator 2007 R2. ClientMediaPort doit être un numéro de port compris entre 1024 et 65535, inclus. La valeur par défaut est 5350.

ClientMediaPortRange

Facultatif

Entier

Indique le nombre total de ports disponibles pour le média client. (La valeur par défaut est 40.) Utilisez ce paramètre pour des clients Office Communicator 2007 R2. Pour déterminer les ports utilisés pour le média client, utilisez cette valeur et la valeur ClientMediaPort. Par exemple, si ClientMediaPort est défini à 5350 et ClientMediaPortRange est défini à 3, les trois ports suivants sont disponibles pour le média client : 5350; 5351; 5352.

ClientMediaPortRangeEnabled

Facultatif

Booléen

Si la valeur True est définie, les clients utiliseront la plage de ports spécifiée pour le trafic multimédia. Si la valeur False est définie (valeur par défaut), tout port disponible (compris entre le port 1024 et le port 65535) sera utilisé pour acheminer le trafic multimédia.

ClientSipDynamicPort

Facultatif

Entier

Représente le numéro de port de début utilisé pour le trafic SIP. ClientSipDynamicPort doit être un numéro de port compris entre 1024 et 65535, inclus. La valeur par défaut est 7100.

ClientSipDynamicPortRange

Facultatif

Entier

Indique le nombre total de ports disponibles pour le trafic SIP. (La valeur par défaut est 3.) Pour déterminer les ports utilisés pour le trafic SIP, utilisez cette valeur et la valeur ClientSipDynamicPort. Par exemple, si ClientSipDynamicPort est défini à 7100 et ClientSipDynamicPortRange est défini à 3, les 3 ports suivants sont disponibles pour le média client : 7100; 7101; 7102.

ClientVideoPort

Facultatif

Entier

Représente le numéro de port de début utilisé pour la vidéo client. ClientVideoPort doit être un numéro de port compris entre 1024 et 65535, inclus. La valeur par défaut est 5350.

ClientVideoPortRange

Facultatif

Entier

Indique le nombre total de ports disponibles pour la vidéo client. (La valeur par défaut est 40.) Pour déterminer les ports utilisés pour la vidéo client, utilisez cette valeur et la valeur ClientVideoPort. Par exemple, si ClientVideoPort est défini à 5350 et ClientVideoPortRange est défini à 3, les trois ports suivants sont disponibles pour la vidéo client : 5350; 5351; 5352.

ConsoleDownloadExternalUrl

Facultatif

Chaîne

URL où les utilisateurs externes peuvent télécharger un client pris en charge tel que Microsoft Lync 2010. Notez que ce paramètre s’applique seulement aux clients hérités (tels que Microsoft Office Communicator 2007 R2) qui se connectent à un pool Lync Server.

ConsoleDownloadInternalUrl

Facultatif

Chaîne

URL où les utilisateurs internes peuvent télécharger un client pris en charge tel que Microsoft Lync 2010. Notez que ce paramètre s’applique seulement aux clients hérités (tels que Microsoft Office Communicator 2007 R2) qui se connectent à un pool Lync Server.

ContentGracePeriod

Facultatif

TimeSpan

Indique la durée pendant laquelle le contenu de la conférence sera conservé sur le serveur une fois la conférence terminée. ContentGracePeriod doit être spécifié en utilisant le format Jours.Heures:Minutes:Secondes. Par exemple, pour définir la période de grâce du contenu à 30 jours, utilisez la syntaxe suivante : -ContentGracePeriod 30.00:00:00.

La période de grâce du contenu peut être définie à n’importe quelle valeur comprise entre 30 minutes (00:30:00) et 180 jours (180.00:00:00). La valeur par défaut est 15 jours (15.00:00:00).

HelpdeskExternalUrl

Facultatif

Chaîne

URL vers laquelle sont dirigés les utilisateurs externes qui cliquent sur l’Aide pendant une conférence.

HelpdeskInternalUrl

Facultatif

Chaîne

URL vers laquelle sont dirigés les utilisateurs internes qui cliquent sur l’Aide pendant une conférence.

MaxBandwidthPerAppSharingServiceMb

Facultatif

Entier

Indique la quantité maximale de bande passante (en mégaoctets) attribuée au service de conférence de partage d’applications. MaxBandwidthPerAppSharingServiceMb peut être défini à n'importe quelle valeur entière comprise entre 50 et 100000, inclus. La valeur par défaut est 375 mégaoctets.

MaxContentStorageMb

Facultatif

Entier

Quantité maximale d’espace de fichier (en mégaoctets) autorisée pour le stockage du contenu de réunion. MaxContentStorageMb peut être défini à n’importe quelle valeur entière comprise entre 50 et 1024 (1 gigaoctet), inclus. La valeur par défaut est 500 mégaoctets.

Organization

Facultatif

Chaîne

Nom de l’organisation qui héberge la conférence.

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.WebConf.ConfSettings. Set-CsConferencingConfiguration accepte les instances transmises via le pipeline de l'objet de configuration de conférence.

Types de retours

Set-CsConferencingConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.

Exemple

Exemple 1

Set-CsConferencingConfiguration -Identity global -Organization Litwareinc

Dans l'exemple 1, Set-CsConferencingConfiguration modifie l'instance globale des paramètres de configuration de conférence ; dans ce cas, la commande définit la valeur de la propriété Organization sur Litwareinc. Cette opération s'effectue en incluant le paramètre Organization suivi du nom de l'organisation : Litwareinc.

Exemple 2

Get-CsConferencingConfiguration | Set-CsConferencingConfiguration -Organization Litwareinc

L'exemple 2 est une extension du premier exemple ; dans ce cas, la commande modifie la valeur de la propriété Organization pour chaque collection de paramètres de configuration de conférence en cours d'utilisation. Pour y parvenir, la commande utilise d'abord Get-CsConferencingConfiguration pour récupérer une collection de tous les paramètres de configuration de conférence. Cette collection est ensuite redirigée vers Set-CsConferencingConfiguration, qui extrait chaque élément de la collection et remplace la valeur de la propriété Organization par Litwareinc.

Exemple 3

Get-CsConferencingConfiguration -Filter site:* | Set-CsConferencingConfiguration -MaxContentStorageMb 50

La commande présentée dans l'exemple 3 modifie la valeur de la propriété MaxContentStorageMb pour tous les paramètres de configuration de conférence appliqués à l'étendue Site. Pour ce faire, la commande appelle d'abord Get-CsConferencingConfiguration ainsi que le paramètre Filter ; la valeur de filtre « site:* » garantit que seuls les paramètres dont l'identité commence par les caractères « site: » sont retournés. La collection filtrée est ensuite redirigée vers Set-CsConferencingConfiguration, qui remplace par 50 la valeur de la propriété MaxContentStorageMb de chaque élément présent dans la collection.

Exemple 4

Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMb -gt 100} | Set-CsConferencingConfiguration -MaxContentStorageMB 100

Dans l’exemple 4, tous les paramètres de configuration de conférence autorisant un stockage du contenu supérieur à 100 mégaoctets sont modifiés, afin de définir le stockage du contenu maximal autorisé à 100 mégaoctets. Pour effectuer cette tâche, la commande appelle d'abord Get-CsConferencingConfiguration (sans aucun paramètre), afin de retourner une collection de tous les paramètres de configuration de conférence en cours d'utilisation. Cette collection est alors redirigée vers la cmdlet Where-Object qui sélectionne les paramètres dont la propriété MaxContentStorageMb est supérieure à (-gt) 100. Cette collection filtrée est ensuite redirigée vers Set-CsConferencingConfiguration qui extrait chaque élément de la collection et définit la valeur de la propriété MaxContentStorageMb sur 100.

Exemple 5

Set-CsConferencingConfiguration -Identity site:Redmond -ContentGracePeriod "22:00:00"

La commande précédente récupère les paramètres de configuration de conférence pour le site Redmond (-Identity site:Redmond) et modifie la valeur de la propriété ContentGracePeriod, afin de définir la période de grâce sur 22 heures (22 heures : 00 minute : 00 seconde).

Exemple 6

Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Fabrikam"} | Set-CsConferencingConfiguration -Organization Litwareinc

Dans l’exemple 6, tous les paramètres de configuration de conférence qui ne comportent pas Fabrikam comme organisation (Organization) sont modifiés. Plus précisément, tous ces paramètres se voient attribuer la valeur Litwareinc comme nouvelle organisation. Pour effectuer cette tâche, la commande appelle d'abord Get-CsConferencingConfiguration (sans aucun paramètre), ce qui retourne une collection de tous les paramètres de configuration de conférence actuellement utilisés dans l'organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne tous les paramètres dont la propriété Organization n'est pas égale à (-ne) Fabrikam. La collection filtrée est alors redirigée vers Set-CsConferencingConfiguration. La cmdlet Set-CsConferencingConfiguration extrait ensuite chaque élément de la collection et remplace la valeur de la propriété Organization par Litwareinc.