Partager via

  • Article

Set-CsDialInConferencingAccessNumber

 

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

Modifie les valeurs de propriétés d’un numéro d’accès de conférence rendez-vous existant. La conférence rendez-vous permet aux utilisateurs d’utiliser un téléphone fixe ou mobile, ou tout autre périphérique sur le réseau téléphonique public commuté pour rejoindre la partie audio d’une conférence.

Syntaxe

Set-CsDialInConferencingAccessNumber -Instance <AccessNumber> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineUri <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-Regions <MultiValuedProperty>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> -Priority <Int32> -ReorderedRegion <String> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La conférence rendez-vous permet aux utilisateurs d’utiliser tout type de téléphone (par exemple, un téléphone fixe, mobile ou VoIP (Voice over Internet Protocol)) pour rejoindre la partie audio d’une conférence. Elle permet aux utilisateurs de participer à la réunion même s’ils n’ont pas d’ordinateur ou de connexion Internet. Les utilisateurs qui s'y connectent bénéficient de fonctionnalités audio complètes : ils peuvent parler aux autres participants et entendre tout ce qui se passe. En revanche, ils ne pourront pas voir les diapositives, flux vidéo et autres éléments visuels partagés.

Pour permettre aux utilisateurs d’utiliser les fonctionnalités de conférence rendez-vous, vous devez créer des numéros d’accès de conférence rendez-vous : il s’agit de numéros de téléphone que les utilisateurs peuvent appeler pour rejoindre une réunion. Les numéros d’accès de conférence rendez-vous sont créés à l’aide de la cmdlet New-CsDialInConferencingAccessNumber. Lorsque vous créez un numéro d’accès de conférence rendez-vous, vous créez en fait un nouvel objet contact dans services de domaine Active Directory (AD DS). Cet objet contact est utilisé pour représenter le numéro d’accès et toutes ses propriétés.

Une fois qu’un numéro de conférence rendez-vous est créé, vous pouvez utiliser la cmdlet Set-CsDialInConferencingAccessNumber pour en modifier les propriétés. Par exemple, vous pouvez modifier le numéro de téléphone lui-même (LineUri) ou encore le nom d’affichage de l’objet contact qui représente ce numéro. De plus, Set-CsDialInConferencingAccessNumber vous permet de modifier l’étendue du numéro ; par exemple, vous pouvez utiliser cette cmdlet pour prendre un numéro qui a été attribué au niveau de l’étendue globale et le réattribuer au niveau de l’étendue Site.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Adresse SIP

Adresse SIP de l’objet contact qui représente le numéro de conférence rendez-vous. Lorsque vous spécifiez la propriété Identity, vous devez inclure le préfixe « sip: » ; par exemple : -Identity " sip:RedmondDialIn@litwareinc.com".

Instance

Facultatif

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

DisplayName

Facultatif

Chaîne

Nom complet Active Directory du nouvel objet contact. Il s’agit du nom qui s’affiche également dans Microsoft Lync 2010.

DisplayNumber

Obligatoire

Chaîne

Numéro de téléphone tel qu'il apparait dans les invitations à une réunion et sur la page Web des paramètres de configuration des conférences rendez-vous. Le DisplayNumber peut être formaté à votre guise ; par exemple 1-800-555-1234, 1-(800)-555-1234 ou 1.800.555.1234.

LineUri

Facultatif

Chaîne

Numéro de téléphone de la conférence rendez-vous. Le paramètre LineUri doit être spécifié à l’aide de la syntaxe suivante : le préfixe « tel: » suivi du signe plus (+), de l’indicatif du pays, de l’indicatif régional et du numéro de téléphone. Par exemple : tel:+18005551234. Les espaces, tirets, parenthèses et autres caractères ne sont pas autorisés.

PassThru

Facultatif

Paramètre de commutateur

Permet de transmettre un objet contact via le pipeline qui représente le numéro modifié d’accès à la conférence rendez-vous. Par défaut, la cmdlet Set-CsDialInConferencingAccessNumber ne transmet aucun objet par l’intermédiaire du pipeline.

PrimaryLanguage

Facultatif

Chaîne

Principale langue utilisée pour les annonces de conférence rendez-vous. La langue doit être configurée à l’aide de l’un des codes linguistiques de conférence rendez-vous disponibles ; par exemple en-US pour l’anglais américain ou fr-FR pour le français. Pour renvoyer une liste de tous les codes linguistiques disponibles, tapez la commande suivante à l’invite Windows PowerShell :

Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages.

Priority

Facultatif

Entier

Vous permet de modifier l’ordre dans lequel les numéros de conférence rendez-vous sont présentés aux utilisateurs dans les invitations à une réunion ou lorsqu’ils accèdent à la page Web Paramètres de conférence rendez-vous. Plus le nombre est bas, plus la priorité est élevée ; autrement dit, pour qu’un numéro apparaisse au début de la liste, définissez sa priorité sur 0. Notez que si vous modifiez la priorité d’un numéro donné, vous devez également utiliser le paramètre ReorderedRegion pour indiquer la région dans laquelle la priorité modifiée doit prendre effet.

Regions

Facultatif

Chaîne

Régions de plan de numérotation associées au numéro d’accès. Si une région n’est pas incluse dans au moins un plan de numérotation, elle ne peut pas être associée à un numéro d’accès à la conférence rendez-vous. Pour spécifier plusieurs régions, utilisez une liste d’éléments séparés par des virgules : -Regions "Northwest", "Southwest"

ReorderedRegion

Facultatif

Chaîne

Paramètre utilisé avec Priority lors de la modification de la priorité d’un numéro de conférence rendez-vous pour une région. Le paramètre ReorderedRegion indique la région dans laquelle le nouvel ordre de priorité doit prendre effet ; par exemple : -ReorderedRegion "Redmond".

ScopeToGlobal

Facultatif

Paramètre de commutateur

Si ce paramètre est présent, le numéro de conférence rendez-vous sera attribué au niveau de l’étendue globale.

ScopeToSite

Facultatif

Paramètre de commutateur

Si ce paramètre est présent, le numéro de conférence rendez-vous sera attribué au niveau de l’étendue Site dans laquelle se trouve le pool de serveurs d’inscriptions de l’objet contact.

SecondaryLanguages

Facultatif

Collection de chaînes

Collection facultative de langues qui peuvent également être utilisées pour les annonces de conférence rendez-vous. Les langues secondaires doivent être configurées sous la forme d’une liste de codes linguistiques séparés par une virgule ; par exemple, la syntaxe suivante définit le français canadien et le français comme langues secondaires : -SecondaryLanguages "fr-CA", "fr-FR".

Un numéro d’accès peut être associé à quatre langues secondaires.

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

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.Xds.AccessNumber. Set-CsDialInConferencingAccessNumber accepte la saisie de données transmises via le pipeline de l’objet numéro d'accès.

Types de retours

Set-CsDialInConferencingAccessNumber ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure des instances de l’objet Microsoft.Rtc.Management.Xds.AccessNumber.

Exemple

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

Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -DisplayName "Redmond Dial-In Access Number"

La commande illustrée dans l’exemple 1 modifie la propriété DisplayName pour le numéro d’accès de conférence rendez-vous avec la propriété Identity sip:RedmondDialIn@litwareinc.com. Dans cet exemple, le nom d’affichage est défini sur « Redmond Dial-In Access Number ».

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

Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -Regions "Redmond", "Seattle"

Dans l’exemple 2, le numéro d’accès de conférence rendez-vous avec la propriété Identity sip:RedmondDialIn@litwareinc.com est modifié pour inclure deux régions : Redmond et Seattle. Pour cela, le paramètre Region est appelé, suivi des deux régions (deux valeurs de chaînes séparées par une virgule). Notez que cette commande échouera si les deux régions, Redmond et Seattle, ne sont pas déjà définies dans des plans de numérotation.

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

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"

Dans l’exemple ci-dessus, tous les numéros d’accès de conférence rendez-vous pour lesquels la langue principale est le français sont modifiés pour utiliser le français canadien comme unique langue secondaire. Pour cela, il faut appeler Get-CsDialInConferencingAccessNumber qui retourne une collection de tous les numéros d’accès de conférence rendez-vous configurés pour l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui choisit uniquement les numéros d’accès dont la propriété PrimaryLanguage est égale à French ("fr-FR"). Cette collection filtrée est alors redirigée vers Set-CsDialInConferencingAccessNumber qui définit la valeur de la propriété SecondaryLanguages sur French Canadian ("fr-CA").

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

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default DialIn Access Number"} | Set-CsDialInConferencingAccessNumber -DisplayName "Litwareinc Conferencing"

La commande illustrée dans l’exemple 4 modifie le nom d’affichage Active Directory pour le numéro d’accès de conférence rendez-vous spécifié. Pour cela, la commande utilise d’abord Get-CsDialInConferencingAccessNumber et le paramètre Filter pour retourner le numéro d’accès dans lequel la propriété DisplayName est égale à "Default DialIn Access Number". Ce numéro d’accès est ensuite redirigé vers la cmdlet Set-CsDialInConferencingAccessNumber qui remplace le nom d’affichage par Litwareinc Conferencing.

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

Get-CsDialInConferencingAccessNumber -Filter {LineUri -eq "TEL:+14255558715"} | Set-CsDialInConferencingAccessNumber -DisplayNumber "1-425-555-1298" -LineUri "tel:+14255551298"

Dans l’exemple 5, le numéro d’affichage et l’URI (Uniform Resource Identifier) de ligne sont modifiés pour le numéro d’accès de conférence rendez-vous. Pour récupérer le numéro à modifier, la commande utilise d’abord Get-CsDialInConferencingAccessNumber et le paramètre Filter ; la valeur de filtre associée limite les données retournées au numéro d’accès dans lequel la propriété LineUri est égale à TEL:+14255558715. Ce numéro d’accès est ensuite redirigé vers Set-CsDialInConferencingAccessNumber, qui en modifie les propriétés DisplayNumber et LineUri.

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

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "en-US"} | Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-FR","it-IT"

La commande ci-dessus attribue une paire de langues secondaires à tous les numéros d’accès de conférence rendez-vous qui n’utilisent pas l’anglais américain comme langue principale. Pour cela, la commande appelle d’abord Get-CsDialInConferencingAccessNumber pour retourner une collection de tous les numéros d’accès de conférence rendez-vous configurés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les numéros pour lesquels la propriété PrimaryLanguage est différente de US English (en-US). La collection filtrée est ensuite redirigée vers Set-CsDialInConferencingAccessNumber qui utilise le paramètre SecondaryLanguages pour attribuer à chaque numéro les langues secondaires French (fr-FR) et Italian (it-IT).

-------------------------- Exemple 7 ------------------------

Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond

La commande dévoilée dans l'exemple 7 affecte au numéro d’accès à la conférence rendez-vous « sip:RedmondDialIn@litwareinc.com » le niveau de priorité le plus élevé pour la région de Redmond ; le numéro figure ainsi en tête de liste des invitations à une réunion et de la page Web des conférences rendez-vous. Pour définir la priorité, on inclut le paramètre Priority, associé à la valeur de paramètre 0. (Le numéro d'accès ayant la priorité la plus élevée possède une valeur Priority de 0, le deuxième numéro prioritaire a une valeur Priority de 1, et ainsi de suite.) En outre, le paramètre ReorderedRegion est inclus pour signaler que les priorités du numéro d'accès ont changé dans la région de Redmond.