Remove-CsExUmContact
Última modificación del tema: 2012-03-25
Quita un objeto de contacto de operador automático o acceso de suscriptor para la Mensajería unificada de Exchange (UM) hospedada.
Sintaxis
Remove-CsExUmContact -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Microsoft Lync Server 2010 funciona en combinación con Mensajería unificada de Exchange para ofrecer varias capacidades de voz, como operador automático y acceso de suscriptor. Cuando Mensajería unificada de Exchange se ofrece como un servicio hospedado (no instalado en la organización), deben crearse objetos de contacto mediante Windows PowerShell para aplicar las funciones de operador automático y acceso de suscriptor. Todos los objetos creados se pueden quitar con el cmdlet Remove-CsExUmContact.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Remove-CsExUmContact: 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-CsExUmContact"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
UserIdParameter |
Identificador único del objeto de contacto que se quiere quitar. Las identidades de contacto pueden especificarse con cuatro formatos: 1) La dirección SIP del contacto; 2) el nombre principal (UPN) del usuario del contacto; 3) el nombre de dominio y nombre de inicio de sesión del contacto con formato dominio\nombre (por ejemplo, litwareinc\exum1); y, 4) el nombre para mostrar de Active Directory del contacto (por ejemplo, Team Auto Attendant). Tipo de datos completo: Microsoft.Rtc.Management.AD.UserIdParameter |
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.OCSADExUmContact. Acepta la entrada transferida de objetos de contacto de Mensajería unificada de Exchange.
Tipos de valores devueltos
Este cmdlet no devuelve un objeto. Quita un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com
En este ejemplo se quita el contacto de Mensajería unificada de Exchange con la dirección SIP exumsa1@fabrikam.com.
-------------------------- Ejemplo 2 --------------------------
Get-CsExUmContact -Filter {LineURI -like "tel:425*"} | Remove-CsExUmContact
En este ejemplo se quitan todos los contactos de Mensajería unificada de Exchange con valores LineURI que empiecen con 425. La primera parte de este comando llama al cmdlet Get-CsExUmContact con el parámetro Filter, usando esta expresión como filtro: LineURI -like "tel:425*". Este filtro especifica que queremos recuperar los objetos de contacto de Mensajería unificada de Exchange que tengan un valor de LineURI que coincida con la cadena de caracteres comodín 425\*. En otras palabras, todos los URI de la línea que empiecen con la cadena 425 y acaben con un conjunto cualquiera de caracteres. Una vez obtenida la colección de objetos, se transfiere al cmdlet Remove-CsExUmContact, que quita todos los elementos de la colección.