Partager via

  • Article

Remove-CsAnalogDevice

 

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

Supprime 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

Remove-CsAnalogDevice [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]

Description détaillée

Parmi les périphériques analogiques se trouvent les téléphones, les télécopieurs, les modems et le périphérique 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 de Voix Entreprise (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 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.

Au fil du temps, il peut s’avérer nécessaire de supprimer un objet de contact associé à un périphérique analogique. Par exemple, si vous retirez du service tous vos télécopieurs, vous n’avez plus besoin d’avoir de périphériques analogiques (et des objets contact) associés à ces machines. La cmdlet Remove-CsAnalogDevice vous fournit un moyen de supprimer des périphériques analogiques. Quand vous exécutez cette cmdlet, le périphérique est supprimé de la liste de périphériques analogiques retournée par Get-CsAnalogDevice. De plus, l’objet contact associé à ce périphérique sera supprimé d’services de domaine Active Directory (AD DS).

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Nom unique Active Directory

Identificateur unique pour le périphérique analogique à supprimer. Les périphériques analogiques sont identifiés à l’aide d’un nom Active Directory unique de l’objet contact associé. Ces périphériques utilisent un identificateur global unique (GUID) par défaut comme nom commun. Cela signifie que les périphériques ont normalement une identité similaire à celle-ci : CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Pour cette raison, vous pouvez trouver qu’il est plus facile de récupérer les périphériques analogiques avec la cmdlet Get-CsAnalogDevice, puis d’acheminer les objets retournés vers Remove-CsAnalogDevice.

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

Objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact. Remove-CsAnalogDevice accepte les instances transmises via le pipeline de l’objet périphérique analogique.

Types de retours

Remove-CsAnalogDevice supprime les instances existantes de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemple

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

Remove-CsAnalogDevice -Identity "CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com"

L’exemple 1 supprime le périphérique analogique dont l’identité est CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com.

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

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

La commande illustrée dans l’exemple 2 supprime tous les périphériques analogiques auxquels ont été affectés le nom complet « Building 14 Receptionist ». Pour effectuer cette tâche, la commande appelle d’abord Get-CsAnalogDevice ainsi que le paramètre Filter. La valeur de filtre {DisplayName -eq "Building 14 Receptionist"} restreint les objets retournés aux périphériques analogiques dont la propriété DisplayName est égale à (-eq) « Building 14 Receptionist ». Les éléments retournés sont ensuite redirigés vers et supprimés par Remove-CsAnalogDevice.

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

Get-CsAnalogDevice -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Remove-CsAnalogDevice

La commande précédente supprime tous les périphériques analogiques affectés à la stratégie vocale RedmondVoicePolicy. Pour ce faire, Get-CsAnalogDevice et le paramètre Filter sont utilisés pour récupérer tous les périphériques analogiques pour lesquelles la propriété est égale à RedmondVoicePolicy. La collection filtrée est ensuite redirigée vers la cmdlet Remove-CsAnalogDevice qui supprime chaque élément dans la collection.

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

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

La commande indiquée à l’exemple 4 supprime tous les fax analogiques actuellement utilisés dans l’organisation. Pour effectuer cette tâche, on appelle d’abord Get-CsAnalogDevice avec le paramètre Filter. La valeur de filtre {AnalogFax –eq $True} choisit uniquement les périphériques dont la propriété AnalogFax est égale à True. La collection filtrée est ensuite redirigée vers Remove-CsAnalogDevice qui supprime chaque élément dans la collection.