Partager via

  • Article

Get-CsAnalogDevice

 

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

Retourne des informations sur les périphériques analogiques que vous pouvez gérer à 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é.

Syntaxe

Get-CsAnalogDevice [-Identity] <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

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 ».

Outre les téléphones analogiques et les téléphones qui bénéficient d’Enterprise Voice, il existe une autre catégorie de téléphones : les téléphones numériques sans IP. Ces téléphones appartiennent au système PBX (autocommutateur privé) avec lequel ils ont été achetés et ne peuvent pas être gérés avec les cmdlets Lync Server 2010.

Afin de permettre aux administrateurs de gérer les périphériques analogiques pour les organisations, 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, par exemple.

La cmdlet Get-CsAnalogDevice permet de récupérer des informations sur les périphériques analogiques configurés pour une utilisation au sein de votre organisation. Si vous appelez Get-CsAnalogDevice sans paramètres, la cmdlet retourne des informations sur tous vos périphériques analogiques. Les paramètres en option fournissent diverses façons de filtrer les informations. Vous pouvez par exemple retourner tous les périphériques ayant des objets contact dans une unité d’organisation (OU) donnée ou tous les périphériques analogiques situés dans un bâtiment précis.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Identificateur unique du périphérique analogique. Les périphériques analogiques sont identifiés à l’aide du 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.

Credential

Facultatif

Objet Credential PS

Permet d’exécuter la cmdlet Get-CsAnalogDevice avec d’autres informations d’identification. Il peut être requis si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler les objets contact.

Pour utiliser le paramètre Credential, vous devez d’abord créer un objet PSCredential à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique d’aide sur la cmdlet Get-Credential.

DomainController

Facultatif

Chaîne

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

Filter

Facultatif

Chaîne

Vous permet de limiter les données retournées en filtrant les attributs spécifiques à Lync Server 2010. Ainsi, vous pouvez limiter les données retournées aux objets contact des périphériques analogiques attribués à une stratégie de voix spécifique, ou encore des contacts attribués à aucune stratégie de voix spécifique.

Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle employée par la cmdlet Where-Object. Par exemple, un filtre qui ne retourne que les télécopieurs est comparable à celui-ci : AnalogFax correspond à l’attribut Active Directory, -eq correspond à l’opérateur de comparaison (égal à) et $True (variable Windows PowerShell intégrée) correspond à la valeur de filtre :

-Filter {AnalogFax -eq $True}

LdapFilter

Facultatif

Chaîne

Permet de limiter les données retournées en filtrant les attributs Active Directory génériques (c’est-à-dire les attributs qui ne sont pas spécifiques à Lync Server 2010). Ainsi, vous pouvez limiter les données retournées aux objets contact attribués à un service spécifique, ou encore situés dans un bâtiment en particulier.

Le paramètre LdapFilter utilise le langage de requête LDAP lors de la création des filtres. Par exemple, un filtre qui retourne uniquement les objets contact représentant des périphériques analogiques de la ville de Redmond se présente comme suit :

-LdapFilter "l=Redmond"

Dans le filtre ci-dessus, « l » correspond à l’attribut Active Directory (localité), « = » correspond à l’opérateur de comparaison (égal à) et « Redmond » correspond à la valeur de filtre.

OU

Facultatif

Nom unique Active Directory

Permet de limiter les objets contact récupérés à partir d’une unité d’organisation (OU) Active Directory spécifique. Il retourne les données provenant de l’unité d’organisation (OU) spécifiée et de toutes ses unités d’organisation enfants. Par exemple, si l’unité d’organisation Finance a deux unités d’organisation enfants, AccountsPayable et AccountsReceivable, les informations de périphérique analogique seront retournées depuis chacune de ces unités d’organisation.

Lors de la spécification d’une unité d’organisation, utilisez le nom unique de ce conteneur. Exemple : -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

Facultatif

Entier

Permet de limiter le nombre d’enregistrements retournés par une commande. Par exemple, pour retourner sept périphériques analogiques (quel que soit le nombre de périphériques analogiques présents dans votre forêt), incluez le paramètre ResultSize et définissez sa valeur à 7. Notez qu’il est impossible de savoir quels seront les sept téléphones retournés. Si vous définissez ResultSize à 7, mais que votre forêt ne compte que trois périphériques analogiques, la commande renverra ces trois périphériques et se terminera sans erreur.

La taille des résultats peut être définie à n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini à 0, la commande s’exécutera, mais aucune donnée ne sera retournée.

Types d’entrées

Chaîne. Get-CsAnalogDevice accepte une valeur de chaîne redirigée représentant l’identité du périphérique analogique.

Types de retours

Get-CsAnalogDevice retourne les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemple

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

Get-CsAnalogDevice

La commande illustrée dans l’exemple 1 retourne une collection de tous les périphériques analogiques configurés pour être utilisés dans l’organisation. Cette action s’effectue par l’appel de la cmdlet Get-CsAnalogDevice sans paramètres.

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

Get-CsAnalogDevice | Select-Object DisplayName, LineUri

Dans l’exemple 2, seules deux valeurs de propriété, DisplayName et LineUri, sont retournées pour tous les périphériques analogiques de l’organisation. Pour effectuer cette tâche, la commande appelle d’abord Get-CsAnalogDevice sans paramètres, ce qui retourne toutes les valeurs de propriété pour tous les périphériques analogiques de l’organisation. Cette collection est ensuite redirigée vers la cmdlet Select-Object qui choisit et affiche seulement les valeurs des propriétés DisplayName et LineUri.

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

Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"}

L’exemple 3 retourne des informations sur le périphérique analogique dont le nom complet Active Directory est "Building 14 Receptionist" (Réceptioniste Bâtiment 14). Pour ce faire, la commande appelle Get-CsAnalogDevice et le paramètre Filter. La valeur du filtre {DisplayName -eq "Building 14 Receptionist"} limite les objets retournés aux périphériques analogiques dont la propriété DisplayName est égale à "Building 14 Receptionist".

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"}

La commande ci-dessus retourne tous les périphériques analogiques configurés pour la passerelle 192.168.0.240. Cette action s’effectue par l’appel de Get-CsAnalogDevice et l’inclusion du paramètre Filter. La valeur de filtre 192.168.0.240 assure que les seuls objets retournés sont des périphériques analogiques dont la propriété Gateway est égale à 192.168.0.240.

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

Get-CsAnalogDevice -Filter {AnalogFax -eq $True}

La commande illustrée dans l’exemple 5 retourne des informations sur tous les télécopieurs analogiques de l’organisation. Pour effectuer cette tâche, la commande appelle Get-CsAnalogDevice et le paramètre Filter. La valeur de filtre {AnalogFax -eq $True} limite les objets retournés aux télécopieurs : périphériques analogiques où la propriété AnalogFax est égale à True.

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

Get-CsAnalogDevice -Filter {LineUri -eq "tel:+14255556001"}

Dans l’exemple 6, un seul périphérique analogique est retourné : le périphérique dont LineUri (numéro de téléphone) est égal à +14255556001.

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

Get-CsAnalogDevice -Filter {LineUri -like "tel:+1425555*"}

L’exemple 7 retourne tous les périphériques analogiques dont l’indicatif régional est 425 et dont le préfixe téléphonique est 555. Pour effectuer cette tâche, on utilise Get-CsAnalogDevice et le paramètre Filter. La valeur de filtre {LineUri -like "tel:+1425555*"} limite les données retournées aux périphériques dont la propriété LineUri commence par les caractères "tel:+1425555". Cette combinaison est équivalente à un numéro de téléphone commençant par les caractères suivants : 1425555 (par exemple, 1-425-555-1298).

-------------------------- Exemple 8 ------------------------

Get-CsAnalogDevice -OU "ou=Telecommunications,dc=litwareinc,dc=com"

La commande ci-dessus retourne une collection de tous les périphériques analogiques ayant un objet contact au sein de l’unité d’organisation Telecommunications dans les services de domaine Active Directory (AD DS). Pour ce faire, la cmdlet Get-CsAnalogDevice est appelée avec le paramètre OU. La valeur de paramètre limite les objets retournés aux périphériques analogiques ayant des objets contact dans l’unité d’organisation dont le nom unique est ou=Telecommunications,dc=litwareinc,dc=com.

-------------------------- Exemple 9 ------------------------

Get-CsAnalogDevice | Grant-CsVoicePolicy -PolicyName "AnalogVoicePolicy"

La commande illustrée dans l’exemple 9 explique comment retourner une collection de périphériques analogiques et attribue ensuite une stratégie de voix à chaque périphérique de la collection. Pour ce faire, la cmdlet Get-CsAnalogDevice est d’abord appelée sans aucun paramètre, ce qui retourne une collection de tous les périphériques analogiques configurés pour être utilisés dans l’organisation. Cette collection est alors redirigée vers la cmdlet Grant-CsVoicePolicy qui affecte la stratégie de voix VoicePolicyRedmond à chaque périphérique.