Get-CsUserAcp
Última modificación del tema: 2012-03-23
Devuelve información sobre los proveedores de audioconferencia asignados a un usuario o grupo de usuarios.
Sintaxis
Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]
Descripción detallada
Un proveedor de audioconferencia es una compañía de terceros que proporciona servicios de conferencia a las organizaciones. Entre otras cosas, los proveedores de audioconferencia ofrecen la posibilidad de que los usuarios puedan participar en la parte de audio de una conferencia o reunión sin estar en la oficina y sin estar conectados a la red corporativa ni Internet. Los proveedores de audioconferencia suelen proporcionar servicios de gama alta, como traducción en directo, transcripción y servicio de operador por conferencia en directo.
Con Microsoft Lync Server 2010, la integración con los proveedores de audioconferencia no es completa. Los cmdlets CsUserAcp permiten a los administradores establecer un número de teléfono y código de acceso, así como configurar otra información que pueda usarse para la integración de los proveedores de audioconferencia cada vez que un usuario programe una reunión. Sin embargo, como estos cmdlets no han sido diseñados para la versión interna de Lync Server, sino que han sido pensados principalmente para ser usados con Microsoft Lync Online 2010, no se ofrece más integración de proveedor de audioconferencia que la asignación de valores de propiedad.
El cmdlet Get-CsUserAcp permite devolver información sobre los proveedores de audioconferencia que se han asignado a un usuario o grupo de usuarios. Para devolver información del proveedor de audioconferencia para un único usuario, incluya simplemente el parámetro Identity seguido de la identidad del usuario cuya información se vaya a devolver. Para devolver información para varios usuarios, puede usar los parámetros LdapFilter o Filter. El parámetro LdapFilter permite usar atributos genéricos de Active Directory como Department o Title cuando se especifica la información de cuenta del usuario; por ejemplo, el valor de parámetro "Title=Accountant" limita la información devuelta a los usuarios que tienen el cargo Accountant. El parámetro Filter permite usar los atributos específicos de Microsoft Lync Server 2010 (como VoicePolicy o EnterpriseVoiceEnabled) para filtrar los datos devueltos. Por ejemplo, el valor de filtro {EnterpriseVoiceEnabled –eq $True} limita las cuentas de usuario que devuelve Get-CsUserAcp a los usuarios que se han habilitado para Enterprise Voice.
También se puede llamar a Get-CsUserAcp sin ningún parámetro para devolver información del proveedor de servicios de audioconferencia para todos los usuarios. Tenga en cuenta que Get-CsUserAcp devuelve información del proveedor de audioconferencia para todos los usuarios, incluidos los que no se hayan habilitado para Lync Server.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsUserAcp: RTCUniversalUserAdmins, RTCUniversalReadOnlyAdmins. 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-CsUserAcp"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad de usuario |
Indica la identidad de la cuenta de usuario que se recuperará. Se puede especificar la identidad de un usuario en cuatro formatos distintos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\inicio de sesión (por ejemplo, litwareinc\kenmyer); y 4) el nombre para mostrar de Active Directory Domain Services (AD DS) del usuario (por ejemplo, Ken Myer). También se puede hacer referencia a una cuenta de usuario mediante el nombre distintivo del usuario de Active Directory. Puede usar el asterisco (*) como comodín al usar el nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena " Smith". |
Credential |
Opcional |
Objeto PSCredential |
Permite ejecutar el cmdlet Get-CsUserAcp 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, primero debe crear un objeto PSCredential con el cmdlet Get-Credential. Si necesita información detallada, consulte el tema de ayuda del cmdlet Get-Credential. |
Filter |
Opcional |
Cadena de caracteres |
Permite limitar los datos que se devuelven filtrando los atributos específicos de Lync Server. Por ejemplo, puede limitar los datos devueltos a usuarios con una directiva de voz específica asignada, o a usuarios que no tengan una directiva de voz específica asignada. El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que solo devuelve usuarios que se hayan habilitado para Enterprise Voice tendría este aspecto; EnterpriseVoiceEnabled representa el atributo de Active Directory Domain Services (AD DS), -eq representa el operador de comparación (igual a) y $True (una variable integrada de Windows PowerShell) representa el valor de filtro: {EnterpriseVoiceEnabled -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. Por ejemplo, puede limitar los datos devueltos a los usuarios que trabajan en un departamento específico o los usuarios que tienen un director o un cargo específicos. El parámetro LdapFilter usa el lenguaje de consulta LDAP al crear filtros. Por ejemplo, un filtro que devuelva sólo usuarios que trabajen en la cuidad de Redmond tendría este aspecto: "l=Redmond", donde "l" (una L minúscula) representa el atributo de Active Directory (localidad), "=" representa el operador de comparación (igual a) y "Redmond" representa el valor de filtro. |
ResultSize |
Opcional |
Entero |
Permite restringir el número de registros que devuelve un comando. Por ejemplo, para devolver siete usuarios (al margen de la cantidad de usuarios que haya en el bosque), incluya el parámetro ResultSize y configure el valor de parámetro como 7. Tenga en cuenta que no es posible especificar qué 7 usuarios se devolverán. Si se define ResultSize como 7 pero sólo tiene tres usuarios en el bosque, el comando devolverá esos tres usuarios y luego 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-CsUserAcp acepta un valor de cadena transferido que representa la identidad de una cuenta de usuario habilitada para Lync Server 2010.
Tipos de valores devueltos
Get-CsUserAcp devuelve instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsUserAcp
El comando que se muestra en el Ejemplo 1 devuelve información sobre el proveedor de audioconferencia para todos los usuarios de la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsUserAcp -Identity "Ken Myer"
El comando anterior devuelve información del proveedor de audioconferencia para un solo usuario: el usuario con la identidad Ken Myer. En este caso, la identidad se especifica usando el nombre para mostrar del usuario de Active Directory.
-------------------------- Ejemplo 3 ------------------------
Get-CsUserAcp -Filter {AcpInfo -ne $Null}
El Ejemplo 3 devuelve información para todos los usuarios a los que se ha asignado como mínimo un proveedor de audioconferencia. Para ello, se incluye el parámetro Filter junto con el valor de filtro {AcpInfo –ne $Null}; este valor de filtro limita los datos devueltos a los usuarios que tengan una propiedad AcpInfo diferente de un valor nulo. Para devolver información sobre los usuarios a los que no se ha asignado ningún proveedor de audioconferencia, use este valor de filtro:
{AcpInfo –eq $Null}
-------------------------- Ejemplo 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"
El comando anterior devuelve información del proveedor de audioconferencia para cualquier usuario al que se haya asignado el proveedor de audioconferencia Fabrikam ACP. Para llevar a cabo esta tarea, el comando primero usa Get-CsUserAcp sin ningún parámetro para devolver información del proveedor de audioconferencia para todos los usuarios de la organización. A continuación, esta información se transfiere al cmdlet Where-Object, que selecciona cualquier usuario cuya propiedad AcpInfo incluya (-match) el valor de cadena "Fabrikam ACP".
-------------------------- Ejemplo 5 ------------------------
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo
En el Ejemplo 5, se muestra información detallada acerca de los proveedores de audioconferencia asignados al usuario Ken Myer. Para ello, primero se llama a Get-CsUserAcp para devolver información del proveedor de audioconferencia para Ken Myer. A continuación, estos datos se transfieren al cmdlet Select-Object, que usa el parámetro ExpandProperty para "expandir" el valor de la propiedad AcpInfo. Cuando se expande un valor de propiedad, simplemente toda la información almacenada en dicho valor se muestra en un formato que resulte fácil de leer.