Test-CsGroupExpansion
Última modificación del tema: 2012-03-27
Comprueba la capacidad de un usuario para usar la expansión de grupos. Microsoft Lync Server 2010 permite a los usuarios configurar un grupo de distribución de Active Directory como un contacto. Al "expandir" un grupo se ve el nombre y la información de presencia de todos los miembros del grupo.
Sintaxis
Test-CsGroupExpansion -TargetFqdn <String> -GroupEmailAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsGroupExpansion -GroupEmailAddress <String> -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsGroupExpansion [-TargetFqdn <String>] -GroupEmailAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
En ocasiones, los usuarios necesitan comunicarse regularmente con todos los miembros de un grupo de distribución de Active Directory. Un grupo puede estar formado, por ejemplo, por todos los miembros de un equipo o todas las personas asignadas a un proyecto particular. Por esto, Lync Server 2010 permite configurar un grupo de distribución como un contacto. Al hacer esto, es posible mandar el mismo mensaje instantáneo a todos los miembros del grupo, enviando el mensaje al grupo, en lugar de a cada miembro individual.
También puede necesitar alguna vez comunicarse con (o comprobar la presencia de) determinadas personas del grupo. La expansión de grupos permite ver, rápida y fácilmente, todos los miembros del grupo y su estado actual. Además de eso, también puede seleccionar uno o más miembros del grupo y, a continuación, enviar un mensaje instantáneo solo a esos usuarios y no a todos los miembros del grupo.
La expansión de grupos se habilita y deshabilita con el cmdlet Set-CsWebServiceConfiguration. Si la expansión de grupos está habilitada, puede comprobar si funciona ejecutando el cmdlet Test-CsGroupExpansion. Con este cmdlet, especifique un grupo de distribución de Active Directory usando la dirección de correo electrónico del grupo. Test-CsGroupExpansion usa la expansión de grupo para recuperar la pertenencia a grupos y comparar la lista recuperada con la pertenencia de la dirección de correo electrónico del grupo que ha proporcionado. Si las dos listas coinciden, la expansión de grupos funciona correctamente.
Puede comprobar la expansión de grupos de dos maneras: probando el propio servicio o probando el servicio web asociado.
Quién puede ejecutar este cmdlet: 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 "Test-CsGroupExpansion"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
GroupEmailAddress |
Requerido |
Cadena de caracteres |
Dirección de correo electrónico del grupo de distribución de destino. Por ejemplo: -GroupEmailAddress "FinanceGroup@litwareinc.com". |
External |
Opcional |
Parámetro modificador |
Permite verificar si los usuarios externos pueden usar la expansión de grupos. |
RegistrarPort |
Entero |
Cadena de caracteres |
Puerto SIP usado por el servicio de registrador. Este parámetro no es necesario si el registrador usa el puerto predeterminado 5061. |
TargetFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de registrador en el que se probará la expansión de grupos. Por ejemplo: -TargetFqdn "atl-cs-001.litwareinc.com". Tenga en cuenta que no se pueden utilizar ambos parámetros, TargetUri y TargetFqdn, dentro del mismo comando. |
TargetUri |
Opcional |
Cadena de caracteres |
Identificador uniforme de recursos (URI) del servicio web de expansión de grupos. Por ejemplo: -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Tenga en cuenta que no se pueden utilizar ambos parámetros, TargetUri y TargetFqdn, dentro del mismo comando. |
UserCredential |
Opcional |
Objeto PSCredential |
Objeto de credencial de la cuenta de usuario que se usará en la prueba. El valor que se pase a UserCredential debe ser una referencia a objeto obtenida mediante el cmdlet Get-Credential. Por ejemplo, este código devuelve un objeto de credenciales del usuario litwareinc\kenmyer y lo almacena en una variable llamada $x: $x = Get-Credential "litwareinc\kenmyer" Deberá especificar la contraseña del usuario al ejecutar este comando. La credencial del usuario no es necesaria si realiza la prueba con las credenciales del usuario activo y el parámetro TargetFqdn. La credencial de usuario es necesaria si usa el parámetro TargetUri. |
UserSipAddress |
Opcional |
Cadena de caracteres |
Dirección SIP del usuario que se usará en la prueba. Si no se especifica este parámetro, Test-CsGroupExpansion realizará las pruebas con la cuenta del usuario que tiene la sesión iniciada. |
WebCredential |
Opcional |
Objeto PSCredential |
Objeto que contiene credenciales de usuario para obtener acceso al Servicio de información de ubicaciones. Este objeto se puede recuperar llamando al cmdlet Get-Credential y facilitando las credenciales correspondientes. Este parámetro es necesario si se han especificado los parámetros TargetUri y UserSipAddress y si el equipo en el que el comando se ejecuta carece de un certificado de servidor. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando. |
OutVerboseVariable |
Opcional |
Cadena de caracteres |
Cuando esté presente, el resultado detallado de ejecutar el cmdlet se almacenará en la variable especificada. Por ejemplo, para almacenar resultados en una variable llamada $TestOutput, utilice la sintaxis siguiente: -OutVerboseVariable TestOutput No anteponga un carácter $ al especificar el nombre de variable. |
Verbose |
Opcional |
Identificador único global |
Genera informes detallados sobre la actividad que aparecen en pantalla a medida que el cmdlet se ejecuta. |
Tipos de entrada
Ninguno. Test-CsGroupExpansion no acepta una entrada transferida.
Tipos de valores devueltos
Test-CsGroupExpansion devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsGroupExpansion -TargetFqdn atl-cs-001.litwareinc.com -GroupEmailAddress FinanceGroup@litwareinc.com
El comando del Ejemplo 1 se conecta con el grupo de registrador atl-cs-001.litwareinc.com para comprobar la expansión de grupos. Para ejecutar la prueba, el comando usa el grupo FinanceGroup@litwareinc.com.