Compartir a través de

  • Artículo

Get-CsAnalogDevice

 

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

Devuelve información sobre los servicios analógicos que se pueden gestionar utilizando Microsoft Lync Server 2010. Un dispositivo analógico es un teléfono u otro dispositivo que está conectado a una red telefónica conmutada.

Sintaxis

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>]

Descripción detallada

Los dispositivos analógicos pueden ser teléfonos, aparatos de fax, módems y teletipos o dispositivos de telecomunicaciones para personas con discapacidades auditivas (TTY/TTD) conectados a la red telefónica conmutada (RTC). A diferencia de los dispositivos que usan Enterprise Voice (sistema de Voz sobre IP (VoIP) que ofrece Microsoft), los dispositivos analógicos no transmiten la información mediante paquetes digitales. En lugar de eso, la información se transmite utilizando una señal continua. Esta señal se denomina señal analógica; de ahí el término “dispositivos analógicos”.

Además de los teléfonos analógicos y los teléfonos que usan Enterprise Voice, hay otro tipo más de teléfonos: los teléfonos digitales que no usan IP. Estos teléfonos son propiedad del sistema central de conmutación (PBX) con el que se compraron y no se pueden controlar utilizando los cmdlets de Lync Server 2010.

Para que los administradores puedan gestionar dispositivos analógicos de las organizaciones, Lync Server 2010 permite asociarlos con objetos de contacto de Active Directory. Al asociar un dispositivo analógico con un objeto de contacto, puede administrarlo mediante operaciones como asignar directivas y planes de marcado al contacto.

El cmdlet Get-CsAnalogDevice permite recuperar información sobre los dispositivos analógicos configurados para usar en la organización. Si llama a Get-CsAnalogDevice sin ningún parámetro, el cmdlet devolverá información sobre todos los dispositivos analógicos. Los parámetros opcionales ofrecen diferentes maneras de filtrar la información; por ejemplo, puede devolver todos los dispositivos que tengan objetos de contacto en una determinada OU o todos los dispositivos analógicos ubicados en cierto edificio, etc.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsAnalogDevice de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Los permisos necesarios para ejecutar este cmdlet para sitios específicos u OU de Active Directory determinados, se pueden asignar con el cmdlet Grant-CsOUPermission. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Parámetro de id. de usuario

Identificador único del dispositivo analógico. Los dispositivos analógicos se identifican mediante el nombre distintivo de Active Directory correspondiente al objeto del contacto asociado. Los dispositivos analógicos usan, de forma predeterminada, un GUID (identificador único global) como nombre común; por ello, la identidad de los dispositivos suele ser similar a la siguiente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Credential

Opcional

Objeto PSCredential

Permite ejecutar el cmdlet Get-CsAnalogDevice con credenciales alternativas. Esto puede ser necesario si la cuenta usada para iniciar sesión en Windows no tiene los privilegios necesarios para trabajar con objetos de contacto.

Para usar el parámetro Credential, utilice primero el cmdlet Get-Credential para crear un objeto PSCredential. Si necesita información detallada, consulte el tema de Ayuda del cmdlet Get-Credential.

DomainController

Opcional

Cadena de caracteres

Permite conectarse al controlador de dominio especificado para recuperar información de contactos. Para conectarse a un controlador de dominio específico, incluya el parámetro DomainController seguido del nombre de dominio completo (FQDN) del equipo, por ejemplo, atl-cs-001.litwareinc.com.

Filter

Opcional

Cadena de caracteres

Permite limitar los datos que se devuelven filtrando los atributos específicos de Lync Server 2010. Por ejemplo, puede limitar los datos devueltos para incluir solo los objetos de contacto de dispositivos analógicos que tengan asignada una determinada directiva de voz, o los usuarios que no tengan asignada una determinada directiva de voz.

El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, así sería un filtro que devuelve solo las máquinas de fax, donde AnalogFax representa el atributo de Active Directory, -eq representa el operador de comparación (igual que), y $True (una variable integrada de Windows PowerShell) representa el valor del filtro:

-Filter {AnalogFax -eq $True}

LdapFilter

Opcional

Cadena de caracteres

Permite limitar los datos que se devuelven filtrando los atributos genéricos de Active Directory, es decir, los atributos que no son específicos de Lync Server 2010. Por ejemplo, puede limitar los datos devueltos para incluir solo los objetos de contacto asignados a cierto departamento, o ubicados en un determinado edificio.

El parámetro LdapFilter usa el lenguaje de consulta LDAP al crear filtros. Por ejemplo, así sería un filtro que devuelve solo los objetos de contacto que representen dispositivos analógicos de la ciudad de Redmond:

-LdapFilter "l=Redmond"

En el filtro anterior, "l" representa el atributo de Active Directory (locality), "=" representa el operador de comparación (igual a) y "Redmond" representa el valor del filtro.

OU

Opcional

Nombre distintivo de Active Directory

Permite devolver objetos de contacto de una unidad organizativa (OU) de Active Directory específica. Se devuelven datos de la unidad organizativa principal especificada y cualquier otra OU que contenga. Por ejemplo, si la OU Finance contiene dos unidades organizativas (AccountsPayable y AccountsReceivable), se devolverá la información de los dispositivos analógicos de estas unidades organizativas.

Al especificar una OU, use el nombre distintivo del contenedor; por ejemplo: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

Opcional

Entero

Permite limitar el número de registros que devuelve un comando. Por ejemplo, para que se devuelvan siete dispositivos analógicos (al margen de la cantidad de dispositivos analógicos que haya en el bosque), incluya el parámetro ResultSize y defina el valor 7 para este parámetro. Tenga en cuenta que no se puede determinar qué siete teléfonos se devolverán. Si se define el valor 7 para el parámetro ResultSize pero solo hay tres dispositivos analógicos en el bosque, el comando devolverá esos tres dispositivos y se completará sin errores.

El tamaño del resultado puede definirse en cualquier número entero entre 0 y 2147483647, ambos incluidos. Si se establece en 0, el comando se ejecutará pero no devolverá datos.

Tipos de entrada

Cadena de caracteres. Get-CsAnalogDevice acepta un valor de cadena transmitido que representa la identidad del dispositivo analógico.

Tipos de valores devueltos

Get-CsAnalogDevice devuelve instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Ejemplo

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

Get-CsAnalogDevice

El comando que se muestra en el Ejemplo 1 devuelve una colección de todos los dispositivos analógicos configurados actualmente para su uso en la organización. Para hacerlo, se llama a Get-CsAnalogDevice sin ningún parámetro.

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

Get-CsAnalogDevice | Select-Object DisplayName, LineUri

En el Ejemplo 2, se devuelven solo dos valores de propiedad (DisplayName y LineUri) de todos los dispositivos analógicos de la organización. Para ejecutar esta tarea, el comando llama primero a Get-CsAnalogDevice sin ningún parámetro; esta acción devuelve todos los valores de propiedad de todos los dispositivos analógicos de la organización. A continuación, se transfiere esta colección al cmdlet Select-Object, que extrae y muestra en pantalla solo los valores de las propiedades DisplayName y LineUri.

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

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

El Ejemplo 3 devuelve información sobre el dispositivo analógico que tiene el nombre para mostrar de Active Directory "Building 14 Receptionist" (Recepcionista del edificio 14). Para hacerlo, el comando llama a Get-CsAnalogDevice y el parámetro Filter; el valor del filtro {DisplayName -eq "Building 14 Receptionist"} limita los objetos devueltos para incluir solo los dispositivos analógicos cuya propiedad DisplayName sea igual a (-eq) "Building 14 Receptionist".

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

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

El comando anterior devuelve todos los dispositivos analógicos configurados para la puerta de enlace 192.168.0.240. Para hacerlo, se llama a Get-CsAnalogDevice y se incluye el parámetro Filter; el valor del filtro "192.168.0.240" garantiza que se los únicos objetos devueltos sean dispositivos analógicos cuya propiedad Gateway sea igual a 192.168.0.240.

-------------------------- Ejemplo 5 ------------------------

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

El comando que se muestra en el Ejemplo 5 devuelve información sobre todas las máquinas de fax analógicas de la organización. Para llevar a cabo esta tarea, el comando llama primero a Get-CsAnalogDevice junto con el parámetro Filter. El valor del filtro {AnalogFax -eq $True} limita los objetos devueltos para incluir solo las máquinas de fax: los dispositivos analógicos cuya propiedad AnalogFax es igual a True.

-------------------------- Ejemplo 6 ------------------------

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

En el Ejemplo 6, solo se devuelve un dispositivo analógico: aquel cuyo LineUri (número de teléfono) es igual a +14255556001.

-------------------------- Ejemplo 7 ------------------------

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

El Ejemplo 7 devuelve todos los dispositivos analógicos cuyo código de área es 425 y cuyo prefijo telefónico es 555. Para ejecutar esta tarea, se usa Get-CsAnalogDevice junto con el parámetro Filter; el valor del filtro {LineUri -like "tel:+1425555*"} limita los datos devueltos para incluir solo los dispositivos cuya propiedad LineUri comience con los caracteres "tel:+1425555". Es equivalente a un número de teléfono que empiece con estos caracteres: 1425555 (por ejemplo, el 1-425-555-1298).

-------------------------- Ejemplo 8 ------------------------

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

El comando anterior devuelve una colección de todos los dispositivos analógicos que tienen un objeto de contacto en la OU Telecommunications de Active Directory Domain Services (AD DS). Para hacerlo, se llama a Get-CsAnalogDevice junto con el parámetro OU; el valor del parámetro limita los objetos devueltos para incluir solo los dispositivos analógicos que tienen objetos de contacto en la OU con nombre distintivo ou=Telecommunications,dc=litwareinc,dc=com.

-------------------------- Ejemplo 9 ------------------------

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

El comando del Ejemplo 9 muestra cómo se puede devolver una colección de dispositivos analógicos y, a continuación, asignar una directiva de voz a cada dispositivo de la colección. Para ellos, se llama primero a Get-CsAnalogDevice sin ningún parámetro, lo que devuelve una colección de todos los dispositivos analógicos configurados para ser utilizados en la organización. Esta colección se transfiere al cmdlet Grant-CsVoicePolicy, el cual asigna la directiva de voz AnalogVoicePolicy a cada dispositivo de la colección.