Partager via

  • Article

Move-CsAnalogDevice

 

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

Déplace un ou plusieurs périphériques analogiques vers un nouveau pool de serveurs d'inscription. Un périphérique analogique est un téléphone ou tout autre appareil connecté au réseau téléphonique commuté (PSTN).

Syntaxe

Move-CsAnalogDevice -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-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, Microsoft 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 Move-CsAnalogDevice permet de déplacer un périphérique analogique existant vers un pool de serveurs d'inscription.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Move-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 "Move-CsAnalogDevice"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

UserID

Identificateur unique du périphérique analogique. 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 similaire à celui-ci : CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Target

Obligatoire

FQDN

Nom de domaine complet (FQDN, par exemple, atl-cs-001.litwareinc.com) du pool de serveurs d'inscriptions vers lequel le périphérique analogique doit être déplacé. Outre un pool de serveurs d'inscription, la cible peut également être le nom de domaine complet (FQDN) d'un fournisseur d'hébergement.

DomainController

Facultatif

FQDN

Permet de vous connecter au contrôleur de domaine spécifié afin de déplacer le périphérique analogique. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l'ordinateur (par exemple, atl-cs-001) ou de son nom de domaine complet (par exemple, atl-cs-001.litwareinc.com).

ProxyPool

Facultatif

FQDN

Ce paramètre est utilisé uniquement pour Microsoft Lync Online 2010. Il ne doit pas être utilisé avec une implémentation sur site de Lync Server.

Force

Facultatif

Paramètre de commutateur

S'il est présent, il déplace le périphérique analogique, mais supprime toutes les données associées (telles que les stratégies qui ont été attribuées au périphérique). S'il est absent, le périphérique est déplacé avec toutes les données associées.

PassThru

Facultatif

Paramètre de commutateur

Permet de transmettre un objet utilisateur via le pipeline qui représente le compte d'utilisateur à déplacer. Par défaut, la cmdlet Move-CsAnalogDevice ne transmet aucun objet par le biais du pipeline.

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

Chaîne. Move-CsAnalogDevice accepte une valeur de chaîne transmise par le pipeline, qui représente l'identité du périphérique analogique.

Types de retours

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

Exemple

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

Move-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com

La commande montrée dans l'exemple 1 déplace le périphérique analogique CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com vers le pool de serveurs d'inscription atl-cs-001.litwareinc.com.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

Dans l'exemple 2, le périphérique analogique dont le nom complet Active Directory est "Building 14, Room 142", est déplacé vers le pool de serveurs d'inscription atl-cs-001.litwareinc.com. Pour ce faire, Get-CsAnalogDevice est d'abord appelée sans aucun paramètre, afin de retourner une collection de tous les périphériques actuellement utilisés dans l'organisation. Cette collection est ensuite transmise vial le pipeline à la cmdlet Where-Object, qui sélectionne tous les périphériques dont le nom complet est "Building 14, Room 142". Une fois filtrée, cette collection est ensuite transmise via le pipeline à Move-CsAnalogDevice, qui déplace tous les périphériques de la collection vers le pool de serveurs d'inscription atl-cs-001.litwareinc.com.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

La commande précédente déplace tous les périphériques analogiques dont le nom complet commence par la valeur de chaîne "Building 14". Pour effectuer cette tâche, la commande appelle d'abord Get-CsAnalogDevice pour retourner une collection de tous les périphériques analogiques actuellement utilisés dans l'organisation. Cette collection est ensuite transmise via le pipeline à la cmdlet Where-Object, qui sélectionne tous les périphériques dont le nom complet commence par la valeur de chaîne "Building 14". Une fois filtrée, la collection est ensuite transmise via le pipeline à Move-CsAnalogDevice, qui déplace chaque périphérique de la collection vers le pool de serveurs d'inscription atl-cs-001.litwareinc.com.