Get-CsAdContact
Última modificación del tema: 2012-03-23
En una topología de varios bosques, devuelve información sobre las cuentas de usuario de todos los bosques, excepto del bosque de inicio. Son usuarios que Microsoft Forefront Identity Manager 2010 (o una versión anterior de este producto) ha replicado como objetos de contacto. Get-CsAdContact devuelve cualquier usuario que tenga un valor configurado para el atributo msRTCSIP-OriginatorSid.
Sintaxis
Get-CsAdContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Descripción detallada
En una topología de varios bosques, los usuarios de otros bosques están presentes como contactos. Estos contactos no equivalen a contactos de Active Directory; si usa usuarios y equipos de Active Directory para crear un nuevo contacto, el cmdlet Get-CsAdContact no devolverá ese usuario. En cambio, Get-CsAdContact sólo devuelve información acerca de los usuarios de todos los bosques menos del bosque de inicio. Si no tiene una topología de varios bosques, no tendrá que llamar a Get-CsAdContact.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsAdContact de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, 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-CsAdContact"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Parámetro UserId |
Indica la Identity del contacto que se devolverá. Las identidades de contacto pueden especificarse utilizando uno de los tres formatos: 1) la dirección SIP del contacto; 2) el nombre distintivo de Active Directory del contacto y 3) el nombre para mostrar de Active Directory del contacto (por ejemplo, Ken Myer). Puede usar el asterisco (*) como comodín al usar el nombre para mostrar como identidad del contacto. Por ejemplo, la identidad "* Smith" devuelve todos los contactos con un nombre para mostrar que termine con el valor de cadena de caracteres " Smith". |
Credential |
Opcional |
Objeto PSCredential |
Permite ejecutar el cmdlet Get-CsAdContact 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 Get-Credential. |
DomainController |
Opcional |
Cadena de caracteres |
Permite conectarse al controlador de dominio especificado para recuperar información de contactos. Para conectarse a un controlador de dominio específico, incluya el parámetro DomainController seguido del nombre de dominio completo (por ejemplo, atl-cs-001.litwareinc.com). |
Filter |
Opcional |
Cadena de caracteres |
Permite limitar los datos que se devuelven filtrando los atributos específicos de Microsoft Lync Server 2010. El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que devuelve únicamente contactos que tienen una dirección SIP que termina en "fabrikam.com" sería: {SipAddress -like "*@fabrikam.com"}, donde SipAddress representa el atributo de Active Directory; -like representa el operador de comparación y "*@fabrikam.com" representa el valor del filtro. |
LdapFilter |
Opcional |
Cadena de caracteres |
Permite limitar los datos que se devuelven filtrando los atributos genéricos de Active Directory. Por ejemplo, puede limitar los datos devueltos a contactos que trabajan en un departamento específico o a contactos con un cargo determinado. El parámetro LdapFilter usa el lenguaje de consulta LDAP al crear filtros. Por ejemplo, un filtro que devuelve el contacto cuyo número de teléfono es 1-425-555-1298 sería: "telephoneNumber=1-425-555-1298", donde "telephoneNumber" representa el atributo de Active Directory; "=" representa el operador de comparación (igual a) y "1-425-555-1298" representa el valor de filtro. |
OU |
Opcional |
Nombre distintivo |
Permite limitar la información recuperada de una unidad organizativa o contenedor concretos de Active Directory. Este parámetro devuelve datos de la unidad organizativa principal especificada y de cualquier otra unidad organizativa que contenga. Por ejemplo, si la unidad organizativa Finance contiene dos unidades organizativas: Se devolverán los contactos AccountsPayable y AccountsReceivable. de cada una de estas tres OU. Al especificar una OU, use el nombre distintivo del contenedor; por ejemplo: OU=Finance,dc=litwareinc,dc=com. |
ResultSize |
Opcional |
Entero |
Permite limitar el número de registros que devuelve el cmdlet. Por ejemplo, para que se devuelvan siete contactos (al margen de la cantidad de contactos que haya en el bosque), incluya el parámetro ResultSize y defina el valor del parámetro en 7. Tenga en cuenta que no es posible especificar qué 7 usuarios se devolverán. 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. Si se define el parámetro ResultSize en 7 pero solo hay tres contactos en el bosque, el comando devolverá esos tres contactos y se completará sin errores. |
Tipos de entrada
Cadena de caracteres. Get-CsAdContact acepta un valor de cadena transferido que representa la identidad de una cuenta de usuario.
Tipos de valores devueltos
Get-CsAdContact devuelve instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.ADContact.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsAdContact
El comando del Ejemplo 1 devuelve una colección de todos los contactos de varios bosques que hay en Active Directory Domain Services (AD DS). Si se llama a Get-CsAdContact sin parámetros adicionales, devuelve todos los valores de propiedad para todos los contactos de Active Directory.
-------------------------- Ejemplo 2 ------------------------
Get-CsAdContact | Select-Object DisplayName, SipAddress
En el Ejemplo 2 se devuelve también una colección de todos los contactos de Active Directory. Sin embargo, en este caso se transfiere al cmdlet Select-Object, que especifica los dos únicos atributos que se mostrarán en pantalla: DisplayName y SipAddress.
-------------------------- Ejemplo 3 ------------------------
Get-CsAdContact -Identity "Ken Myer"
El comando anterior devuelve información sobre un único contacto de Active Directory: el usuario con la identidad "Ken Myer".
-------------------------- Ejemplo 4 ------------------------
Get-CsAdContact -LdapFilter "Organization=Fabrikam"
En el Ejemplo 4, el comando devuelve todos los contactos de Active Directory que trabajan para Fabrikam. Para ello, se llama a Get-CsAdContact, junto con el parámetro LdapFilter. En este ejemplo, limita los datos devueltos a contactos que tienen el atributo Organization definido en "Fabrikam".
-------------------------- Ejemplo 5 ------------------------
$x = Get-Credential -Credential "litwareinc\administrator"
Get-CsAdContact -Credential $x
Los dos comandos que se muestran en el Ejemplo 5 ilustran el uso del parámetro Credential, que permite ejecutar Get-CsAdContact con credenciales alternativas. En el primer comando, se llama al cmdlet Get-Credential para crear un objeto PSCredential para la cuenta litwareinc\administrator. Este comando muestra un cuadro de diálogo de solicitud de credenciales del usuario litwareinc\administrator; cuando se escribe la contraseña de esta cuenta, esa información de credenciales se almacena en la variable $x. En el segundo comando, se llama a Get-CsAdContact junto con el parámetro Credential. El valor de parámetro $x indica que Get-CsAdContact debe ejecutarse con la cuenta litwareinc\administrator.