• Article

New-CsConferencingConfiguration

 

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

Crée une nouvelle collection de paramètres de configuration de conférence. Les paramètres de conférence déterminent certains éléments comme la taille maximale autorisée des documents et du contenu de la conférence, la période de grâce du contenu (à savoir, la durée pendant laquelle le contenu sera stocké avant d'être supprimé) et les URL des téléchargements internes et externes du client pris en charge.

Syntaxe

New-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>] [-InMemory <SwitchParameter>] [-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.

Les administrateurs doivent également gérer le 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. Veuillez noter que les nouveaux paramètres peuvent uniquement être appliqués dans l’étendue Site ou Service ; vous ne pouvez pas créer une nouvelle collection globale de paramètres de configuration de conférence. En outre, aucun site ou service ne peut héberger plus d’une collection de paramètres. Si vous essayez de créer de nouveaux paramètres pour le site Redmond et que le site Redmond héberge déjà une collection de paramètres de configuration de conférence, votre commande échouera.

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-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 "New-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 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". Veuillez noter que le service de conférence Web est le seul service qui peut héberger ces paramètres de configuration.

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 3 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 trois 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 après la fin d'une réunion. 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 conférence. 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.

Organization

Facultatif

Chaîne

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

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.

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

Aucun. New-CsConferencingConfiguration n'accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsConferencingConfiguration crée de nouvelles instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.

Exemple

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

New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc

La commande précédente crée une nouvelle collection de paramètres de configuration de conférence pour le site Redmond (site:Redmond). Dans cet exemple, un paramètre supplémentaire a été inclus (Organization). Celui-ci définit la valeur de la propriété Organization sur Litwareinc. Veuillez noter que cette commande échouera si le site Redmond comporte déjà une collection de paramètres de configuration de conférence. Ceci est dû au fait que vous êtes limité à une seule collection par site.

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

$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x

Dans l’exemple 2, une nouvelle collection de paramètres de configuration de conférence est initialement créée en mémoire uniquement ; ces paramètres virtuels ne seront appliqués que plus tard au site Redmond. Pour ce faire, la première commande de cet exemple utilise la cmdlet New-CsConferencingConfiguration pour créer une nouvelle collection de paramètres en mémoire stockée dans la variable $x ; le paramètre InMemory spécifie que la collection doit être créée en mémoire au lieu d'être immédiatement appliquée au site Redmond.

Une fois la collection créée, la deuxième commande définit la valeur de la propriété Organization sur Litwareinc. Enfin, la troisième commande utilise Set-CsConferencingConfiguration pour appliquer les nouveaux paramètres au site Redmond. (Cette commande échouera si les paramètres de configuration de conférence ont déjà été appliqués à site Redmond.) Si vous n'appelez pas Set-CsConferencingConfiguration, les nouveaux paramètres ne s'appliquent pas. Ils disparaissent dès que vous mettez fin à votre session Windows PowerShell ou supprimez la variable $x.