Set-CsUserAcp
Última modificación del tema: 2012-03-27
Agrega un nuevo proveedor de audioconferencia a un usuario o a un grupo de usuarios, o bien modifica un proveedor de audioconferencia existente que ya está asignado a un usuario.
Sintaxis
Set-CsUserAcp -Identity <UserIdParameter> -Domain <String> -Name <String> -ParticipantPasscode <String> -TollNumber <String> [-Confirm [<SwitchParameter>]] [-IsDefault <$true | $false>] [-PassThru <SwitchParameter>] [-TollFreeNumbers <String[]>] [-Url <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Un proveedor de audioconferencia es una compañía que proporciona servicios de conferencia a las organizaciones. Entre otras cosas, los proveedores de audioconferencia permiten a los usuarios que no se encuentren en la oficina, y que no estén conectados a la red corporativa o Internet, participar en la parte de audio de una conferencia o una reunión. 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.
Microsoft Lync Server 2010 no permite la integración completa con proveedores de audioconferencia. Los cmdlets CsUserAcp permiten a los administradores establecer un número de teléfono y un código de acceso, y configurar otra información que se pueda utilizar para la integración con el proveedor de audioconferencia, cada vez que un usuario programa una reunión. Sin embargo, dado que estos cmdlets no se han diseñado para la versión local de Lync Server (están destinados principalmente a su uso con Microsoft Lync Online 2010), no se ofrece más integración con el proveedor de audioconferencia, aparte de la asignación de valores a las propiedades.
Los proveedores de audioconferencia se pueden asignar a una cuenta de usuario con el cmdlet Set-CsUserAcp. (Tenga en cuenta que es posible asignar varios proveedores de audioconferencia a un mismo usuario.) Set-CsUserAcp también se usa para modificar las propiedades de un proveedor de audioconferencia existente. Si llama a Set-CsUserAcp, el cmdlet usa la información de parámetro incluida en la llamada para comprobar los proveedores de audioconferencia existentes que tiene asignados el usuario. Si se encuentra alguna coincidencia, se modifica el proveedor existente. Por ejemplo, suponga que ejecuta el siguiente comando:
Set-CsUserAcp –Identity "Ken Myer" –TollNumber "15554251298" –ParticipantPassCode 13761 –Domain "fabrikam.com" –Name "Fabrikam ACP"
Suponga también que Ken Myer ya se ha asignado a un proveedor de audioconferencia denominado Fabrikam ACP, que tiene los mismos valores de TollNumber y Domain que los especificados en el comando. (En otras palabras, la única diferencia es el valor de ParticipantPassCode.) En este caso, Set-CsUserAcp modificará el proveedor Fabrikam ACP existente. Si no se encuentra ninguna coincidencia, se agregará un nuevo proveedor a la cuenta de usuario de Ken Myer.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Set-CsUserAcp localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserAcp"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad de usuario |
Indica la identidad de la cuenta de usuario que se modificará. Puede especificar la identidad de un usuario mediante uno de estos cuatro formatos: 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\nombre (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 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 de caracteres " Smith". |
Domain |
Requerido |
Cadena de caracteres |
Nombre de dominio del proveedor de audioconferencia. Por ejemplo: -Domain "fabrikam.com". |
Name |
Requerido |
Cadena de caracteres |
Nombre del proveedor de audioconferencia. Por ejemplo: -Name "Fabrikam Conference Services". |
ParticipantPasscode |
Requerido |
Cadena de caracteres |
Código de acceso necesario para conectarse a una conferencia a través del proveedor de audioconferencia. Por ejemplo: -PassCode "0712". |
TollNumber |
Requerido |
Cadena de caracteres |
Número de teléfono de pago usado para las audioconferencias. Por ejemplo: -TollNumber "14255551298". |
IsDefault |
Opcional |
Booleano |
Indica si es el proveedor de audioconferencia predeterminado para el usuario. Cada usuario puede tener un solo proveedor predeterminado. |
TollFreeNumbers |
Opcional |
Cadena de caracteres |
Recopilación del número de teléfono gratuito usado para las audioconferencias. Por ejemplo: -TollFreeNumbers "18005551298". Para agregar varios números gratuitos, separe los números mediante comas: -TollFreeNumber "18005551298", "18005559876". |
Url |
Opcional |
Cadena de caracteres |
Dirección URL del proveedor de audioconferencia, por ejemplo: -Url "http://acp.fabrikam.com". La URL de la web permite a los proveedores de audioconferencia dirigir a los usuarios a una página web que contenga números de teléfono de acceso telefónico adicionales, así como información sobre los servicios que ofrece el proveedor de audioconferencia. |
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 Set-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. Set-CsUserAcp acepta un valor alfanumérico por canalización que represente la identidad de una cuenta de usuario que se haya habilitado para Lync Server 2010. El cmdlet acepta también las instancias por canalización del objeto de usuario de Active Directory.
Tipos de valores devueltos
Ninguno.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
En el Ejemplo 1, se usa Set-CsUserAcp para asignar un nuevo proveedor de audioconferencia al usuario Ken Myer. Para hacerlo, se utiliza el parámetro Identity para indicar la cuenta de usuario que se modificará. Además, se incluyen los parámetros obligatorios TollNumber, ParticipantPassCode, Domain y Name junto con los valores de parámetro pertinentes.
-------------------------- Ejemplo 2 ------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUserAcp -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
El comando mostrado en el Ejemplo 2 asigna el mismo proveedor de audioconferencia a todos los usuarios que trabajan en el departamento de Finanzas (Finance). Para ello, el comando usa primero Get-CsUser y LdapFilter (con el valor de filtro "Department=Finance") para devolver una recopilación de todos los usuarios que trabajan en el departamento de Finanzas. A continuación, esta recopilación se transfiere al cmdlet Set-CsUserAcp, que asigna el mismo proveedor de audioconferencia (Fabrikam ACP) a todos los usuarios de la recopilación.
-------------------------- Ejemplo 3 ------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP" -TollFreeNumbers "18005551010", "18005551020"
El comando anterior asigna el proveedor de audioconferencia Fabrikam ACP al usuario Ken Myer. Además de especificar los valores de TollNumber, ParticipantPassCode, Domain y Name, este comando también incluye un par de números de teléfono gratuitos. Para asignar estos dos valores, se incluye el parámetro TollFreeNumbers seguido de los dos números de teléfono, separados por comas.