Compartir a través de

  • Artículo

Remove-CsAnalogDevice

 

Última modificación del tema: 2012-03-27

Elimina un dispositivo existente de la colección de dispositivos analógicos que se pueden administrar mediante Microsoft Lync Server 2010. Un dispositivo analógico es un teléfono u otro dispositivo conectado a la red telefónica conmutada (RTC).

Sintaxis

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

Descripción detallada

Los dispositivos analógicos son, por ejemplo, teléfonos, máquinas de fax, módems y dispositivo TTY/TTD (teletipos/dispositivos de telecomunicaciones para personas con discapacidades auditivas) conectados a la red telefónica conmutada (RTC). A diferencia de los dispositivos que usan Enterprise Voice (que es la solución de voz sobre IP o VoIP que Microsoft ofrece), los dispositivos analógicos no transmiten la información mediante paquetes digitales, sino a través de señales continuas. Esta señal se denomina señal analógica; de ahí el término “dispositivos analógicos”.

Para que los administradores puedan controlar dispositivos analógicos, Lync Server 2010 permite asociarlos con objetos de contacto de Active Directory. Al asociar un dispositivo analógico a un objeto de contacto, puede administrarlo asignando directivas y planes de marcado al contacto.

Con el tiempo, puede que necesite eliminar un objeto de contacto asociado con un dispositivo analógico. Por ejemplo, si acaba desechando todos los faxes, dejará de necesitar los dispositivos analógicos (y objetos de contactos) asociados a dichas máquinas. El cmdlet Remove-CsAnalogDevice proporciona una manera de eliminar dispositivos analógicos. Cuando ejecuta este cmdlet, el dispositivo se eliminará de la lista de dispositivos analógicos devuelta por Get-CsAnalogDevice. Además, también se eliminará de Active Directory Domain Services (AD DS) el objeto de contacto asociado a dicho dispositivo.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsAnalogDevice localmente: RTCUniversalUserAdmins. Los permisos necesarios para ejecutar este cmdlet en sitios concretos o unidades organizativas de Active se pueden asignar a través del cmdlet Grant-CsOUPermission. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAnalogDevice"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Nombre distintivo de Active Directory

Identificador único del dispositivo analógico que se eliminará. Los dispositivos analógicos se identifican mediante el nombre distintivo de Active Directory correspondiente al objeto de contacto asociado. Estos dispositivos usan de forma predeterminada un identificador único global (GUID) como nombre común; por ello, el parámetro Identity de los dispositivos analógicos suele ser similar al siguiente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Este es el motivo por el que puede que sea más fácil encontrar los dispositivos analógicos usando el cmdlet Get-CsAnalogDevice y transfiriendo a continuación a Remove-CsAnalogDevice los objetos devueltos.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact. Remove-CsAnalogDevice acepta instancias transferidas del objeto de dispositivo analógico.

Tipos de valores devueltos

Remove-CsAnalogDevice elimina las instancias existentes del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

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

En el Ejemplo 1 se elimina el dispositivo analógico que tiene como Identidad CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com.

-------------------------- Ejemplo 2 ------------------------

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

El comando que se muestra en el ejemplo 2 elimina cualquier dispositivo analógico al que se haya asignado el nombre para mostrar "Building 14 Receptionist". Para realizar esta tarea, el comando llama primero a Get-CsAnalogDevice junto con el parámetro Filter. El valor de filtro {DisplayName -eq "Building 14 Receptionist"} limita los resultados a los dispositivos analógicos en los que la propiedad DisplayName es igual a "Building 14 Receptionist". A continuación, los elementos devueltos se transfieren a Remove-CsAnalogDevice para su eliminación.

-------------------------- Ejemplo 3 ------------------------

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

El comando anterior borra todos los dispositivos analógicos que se han asignado a la directiva de voz RedmondVoicePolicy. Para hacerlo, Get-CsAnalogDevice y el parámetro Filter se usan para recuperar todos los dispositivos analógicos en los que la propiedad VoicePolicy es igual a RedmondVoicePolicy. La colección filtrada se transfiere al cmdlet Remove-CsAnalogDevice, que elimina cada uno de los elementos de la colección.

-------------------------- Ejemplo 4 ------------------------

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

El comando que se muestra en el Ejemplo 4 elimina todas las máquinas de fax analógicas que se encuentran en uso en la organización. Para realizar esta tarea, se llama en primer lugar a Get-CsAnalogDevice junto con el parámetro Filter. El valor de filtrado {AnalogFax –eq $True} solo selecciona los dispositivos en los que la propiedad AnalogFax es igual a True. Después, la colección filtrada se transfiere a Remove-CsAnalogDevice, que elimina cada uno de los elementos de la colección.