Partager via

  • Article

Set-CsAnalogDevice

 

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

Modifie un périphérique existant de la collection de périphériques analogiques pouvant être gérés à 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

Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-Gateway <Fqdn>] [-LineURI <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 (à savoir, 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 Set-CsAnalogDevice vous permet de modifier les propriétés des objets contact associés à des périphériques analogiques. Vous pouvez, par exemple, modifier le nom complet Active Directory du contact ou l’URI (Uniform Resource Identifier) de ligne associé au périphérique.

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-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 "Set-CsAnalogDevice"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Identificateur unique du périphérique analogique modifié. Les périphériques analogiques sont identifiés à l’aide d’un nom Active Directory unique de l’objet contact associé. Par défaut, les périphériques analogiques utilisent un identificateur global unique (GUID) comme nom commun et ont donc généralement un identificateur semblable à celui-ci : CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Par conséquent, vous pouvez trouver qu’il est plus facile de modifier les périphériques analogiques avec la cmdlet Get-CsAnalogDevice pour retourner les objets de périphériques analogiques, puis de rediriger ces objets vers Set-CsAnalogDevice.

Gateway

Facultatif

Chaîne

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

AnalogFax

Facultatif

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.

LineURI

Facultatif

Chaîne

Numéro de téléphone pour le périphérique analogique. Vous devez entrer l’URI 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 qui permet au périphérique analogique de communiquer avec 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.

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.

DomainController

Facultatif

Paramètre de commutateur

Permet de se connecter au contrôleur de domaine spécifié, afin de modifier des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l’ordinateur (par exemple, atl-mcs-001) ou son nom de domaine complet (FDQN), par exemple, atl-mcs-001.litwareinc.com.

Enabled

Facultatif

True

Lorsque la valeur est True ($True), le périphérique analogique peut être utilisé avec Lync Server 2010.

EnterpriseVoiceEnabled

Facultatif

Booléen

Indique si l’objet contact du périphérique analogique a été activé pour Enterprise Voice, l’implémentation par Microsoft de la voix sur IP, ou « VoIP ». Avec Enterprise Voice, les utilisateurs peuvent passer des appels téléphoniques via Internet au lieu d’utiliser le réseau téléphonique standard.

PassThru

Facultatif

Paramètre de commutateur

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

WhatIf

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.ADConnect.Schema.OCSADAnalogDeviceContact. Set-CsAnalogDevice accepte les instances transmises via le pipeline de l’objet du périphérique analogique.

Types de retours

Par défaut, Set-CsAnalogDevice ne retourne ni objet, ni valeur. Toutefois, si vous incluez le paramètre PassThru, la cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemple

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

Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"

La commande précédente modifie la valeur de la propriété LineUri pour le périphérique analogique dont l’identité (Identity) est CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"

La commande de l’exemple 2 modifie la passerelle de chaque périphérique analogique utilisant actuellement la passerelle 192.168.0.240. Pour exécuter cette tâche, la cmdlet Get-CsAnalogDevice est appelée avec le paramètre Filter. La valeur de filtre {Gateway -eq « 192.168.0.240 »} garantit que seuls les périphériques comportant une passerelle égale à (-eq) 192.168.0.240 sont retournés. La collection filtrée est ensuite redirigée vers Set-CsAnalogDevice, qui sélectionne chaque élément de la collection et remplace la valeur de la propriété Gateway par 192.168.1.100.