Partager via

  • Article

New-CsAnalogDevice

 

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

Permet de créer un nouveau périphérique analogique qui peut être géré à l’aide de Microsoft Lync Server 2010. Un périphérique analogique est un téléphone ou tout autre appareil connecté au réseau téléphonique commuté (PSTN).

Syntaxe

New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Parmi les périphériques analogiques se trouvent les téléphones, les télécopieurs, les modems et les périphériques TTY/TDD (téléscripteur/appareil de télécommunications pour malentendants) connectés au réseau téléphonique commuté (PSTN). À l’inverse des périphériques tirant parti d’Enterprise Voice (l’implémentation par Microsoft de la voix sur IP, ou « VoIP »), les périphériques analogiques ne transmettent pas d’informations à l’aide de paquets numériques. Au lieu de cela, les informations sont transmises à l’aide d’un signal continu. Ce signal est connu sous le nom de signal analogique, d’où le terme « périphériques analogiques ».

Afin de permettre aux administrateurs de gérer les périphériques analogiques, Lync Server 2010 vous permet d’associer des périphériques analogiques à des objets contact Active Directory. Après l’association d’un périphérique à un objet contact, vous pouvez alors gérer le périphérique analogique en attribuant des stratégies et des plans de numérotation au contact.

La cmdlet New-CsAnalogDevice permet de créer de nouveaux périphériques analogiques. Cette cmdlet peut soit créer de nouveaux objets contact à utiliser avec des périphériques analogiques, soit associer des objets contact existants à un nouveau périphérique. Pour plus d’informations, consultez les descriptions des paramètres OU et DN.

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-CsAnalogDevice : RTCUniversalUserAdmins. Les autorisations d’exécuter cette cmdlet pour des sites spécifiques ou des unités d’organisation Active Directory spécifiques peuvent être attribuées au moyen de la cmdlet Grant-CsOUPermission. 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-CsAnalogDevice"}

Paramètres

Paramètre Obligatoire Type Description

LineUri

Obligatoire

Chaîne

Numéro de téléphone pour le périphérique analogique. Vous devez entrer l’URI (Uniform Resource Identifier) de ligne au format E.164 en utilisant le préfixe « TEL: ». Par exemple : TEL:+14255551297. Tout numéro de poste doit être ajouté à la fin de l’URI de ligne ; par exemple : « TEL:+14255551297; ext=51297 ».

SipAddress

Facultatif

Adresse SIP

Identificateur unique (similaire à une adresse de messagerie) qui permet au périphérique analogique de communiquer via des périphériques SIP tels que Microsoft Lync 2010. L’adresse SIP doit être précédée du préfixe « sip: ». Par exemple : sip:bldg14lobby@litwareinc.com.

RegistrarPool

Obligatoire

Chaîne

Nom de domaine complet (FQDN) du pool de serveurs d’inscriptions où l’objet contact doit être hébergé. Par exemple : -RegistrarPool "atl-cs-001.litwareinc.com".

DisplayName

Facultatif

Chaîne

Configure le nom complet Active Directory du périphérique analogique.

DisplayNumber

Facultatif

Chaîne

Numéro de téléphone tel qu’il est affiché dans Lync 2010. La propriété DisplayNumber peut prendre le format que vous souhaitez, par exemple 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234, etc.

AnalogFax

Obligatoire

Booléen

À définir sur True ($True) si le périphérique analogique est un télécopieur. À définir sur False ($False) si le périphérique n’est pas un télécopieur.

Gateway

Obligatoire

Chaîne

Adresse IP de la passerelle PSTN que doit utiliser le périphérique analogique.

OU

Obligatoire

Nom unique Active Directory

Nom unique de l’unité d’organisation (OU) Active Directory où l’objet contact doit se trouver. Par exemple : -OU "ou=Redmond,dc=litwareinc,dc=com”.

Si vous incluez le paramètre OU, un nouveau contact sera créé dans l’unité d’organisation spécifiée, et un GUID (identificateur global unique) sera automatiquement attribué comme nom commun. Ainsi, l’objet contact aura un nom du type : {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

DN

Facultatif

Nom unique Active Directory

Vous permet d’associer un objet contact Active Directory au périphérique analogique. Si vous souhaitez associer un objet contact à un périphérique analogique, utilisez le paramètre DN suivi du nom unique de ce contact. Par exemple : -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Remarquez que la commande échouera si le contact spécifié n’existe pas.

Vous ne pouvez pas utiliser les paramètres OU et DN dans la même commande.

PassThru

Facultatif

Paramètre de commutateur

Retourne un objet représentant le téléphone en zone commune.

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

Types de retours

New-CsAnalogDevice crée de nouvelles instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemple

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

New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com"

La commande de l’exemple 1 crée un nouveau périphérique analogique avec le numéro de téléphone (LineUri) 1-425-555-6001. (Notez que vous devez spécifier le numéro de téléphone en utilisant le format E.164.) Outre le paramètre LineUri, les autres paramètres utilisés dans cette commande sont DisplayName (pour configurer le nom complet Active Directory du périphérique), RegistrarPool (pour indiquer le pool de serveurs d’inscriptions), AnalogFax (défini sur $False pour indiquer qu’il s’agit d’un numéro de téléphone et non d’un télécopieur), Gateway (configuré avec l’adresse IP de la passerelle) et OU (le nom unique de l’unité d’organisation Active Directory où l’objet contact du périphérique doit être créé).