Remove-CsUserAcp
Última modificación del tema: 2012-03-25
Quita uno o más proveedores de audioconferencia asignados a un usuario o grupo de usuarios.
Sintaxis
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <String>] [-WhatIf [<SwitchParameter>]]
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.
Cualquier proveedor de audioconferencia asignado a un usuario puede quitarse posteriormente con el cmdlet Remove-CsUserAcp. Al llamar a Remove-CsUserAcp sin ningún parámetro (que no sea el parámetro Identity, que indica la cuenta de usuario que se va a modificar), se quitan todos los proveedores de audioconferencia asignados a un usuario. También puede usar los parámetros opcionales que se incluyen con Remove-CsUserAcp para quitar los proveedores seleccionados de una cuenta de usuario. Por ejemplo, este comando busca la cuenta de usuario Ken Myer y quita todos los proveedores de audioconferencia que tengan un nombre igual a "Fabrikam ACP":
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
Para quitar proveedores de audioconferencia de una forma más específica, basta con incluir parámetros adicionales. Por ejemplo, este comando quita los proveedores de audioconferencia que tengan el nombre "Fabrikam ACP" cuyo valor de TollNumber sea igual a "14255551298", como en:
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Remove-CsUserAcp: RTCUniversalUserAdmins. 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 "Remove-CsUserAcp"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad de usuario |
Indica la identidad de la cuenta de usuario de la que se va a quitar el proveedor de audioconferencia. 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 las identidades de usuario mediante el nombre distintivo del usuario en 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". |
Name |
Opcional |
Cadena de caracteres |
Nombre del proveedor de audioconferencia. Por ejemplo: -Name "Fabrikam Conference Services". |
ParticipantPassCode |
Opcional |
Cadena de caracteres |
Código de acceso necesario para conectarse a una conferencia mediante el proveedor de audiconferencia. Por ejemplo: -PassCode "0712". |
TollNumber |
Opcional |
Cadena de caracteres |
Número de teléfono no gratuito usado para audioconferencias. Por ejemplo: -TollNumber "14255551298". |
PassThru |
Opcional |
Parámetro modificador |
Permite enviar un objeto de usuario a través de la canalización que representa el usuario al que se está quitando el proveedor de audioconferencia. De forma predeterminada, el cmdlet Remove-CsUserAcp no envía objetos a través de la canalización. |
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
Cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Remove-CsUserAcp acepta un valor de cadena transferido que representa la identidad de una cuenta de usuario habilitada para Microsoft Lync Server 2010. El cmdlet también acepta las instancias transferidas del objeto de usuario de Active Directory.
Tipos de valores devueltos
Ninguno.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"
El comando del Ejemplo 1 quita todos los proveedores de audioconferencia que se hayan asignado al usuario Ken Myer.
-------------------------- Ejemplo 2 ------------------------
Get-CsUser | Remove-CsUserAcp
El Ejemplo 2 muestra cómo quitar todos los proveedores de audioconferencia que se han asignado a todos los usuarios habilitados para Lync Server 2010. Para ello, el comando primero usa Get-CsUser para recuperar una colección de todos los usuarios que se han habilitado para Lync Server. A continuación, la colección se transfiere al cmdlet Remove-CsUserAcp, que quita todos los proveedores de audioconferencia asignados a cada usuario de la colección.
-------------------------- Ejemplo 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
En el Ejemplo 3, todos los proveedores de audioconferencia con el nombre "Fabrikam ACP" se quitan de la cuenta de usuario de Ken Myer.
-------------------------- Ejemplo 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
El comando anterior quita el proveedor de audioconferencia con el número de teléfono de pago "14255551298" de todas las cuentas de usuario a las que se haya asignado un proveedor de audioconferencia. Para llevar a cabo esta tarea, el comando primero usa Get-CsUserAcp para devolver información sobre todos los proveedores de audioconferencia asignados a todos los usuarios. A continuación, esta información se transfiere al cmdlet Where-Object, que selecciona solo las cuentas cuya propiedad AcpInfo incluya (-match) el número de teléfono "14255551298". La colección filtrada se transfiere al cmdlet Remove-CsUserAcp, que quita el proveedor de servicios de audioconferencia correspondiente de cada cuenta de la colección filtrada.