Get-ADGroup (Español)

Módulo: ActiveDirectory

Obtiene uno o más grupos de Active Directory.

Sintaxis

Descripción

El cmdlet Get-ADGroup obtiene un grupo o realiza una búsqueda para recuperar varios grupos de un Active Directory.

La identidad El parámetro especifica el grupo de Active Directory que se va a obtener. Puede identificar un grupo por su nombre distinguido (DN), GUID, identificador de seguridad (SID), nombre de cuenta del Administrador de cuentas de seguridad (SAM) o nombre canónico. También puede especificar la variable de objeto de grupo , como $<localGroupObject>.

Para buscar y recuperar más de un grupo, use los parámetros Filter o LDAPFilter. El parámetro Filter usa el lenguaje de expresión de PowerShell para escribir cadenas de consulta para Active Directory. La sintaxis del lenguaje de expresión PowerShell proporciona compatibilidad con la conversión de tipos enriquecidos para los tipos de valor recibidos por el parámetro Filter. Para obtener más información sobre la sintaxis del parámetro Filter, escriba . Si tiene cadenas de consulta de Protocolo ligero de acceso a directorios (LDAP), puede usar el parámetro LDAPFilter.

Este cmdlet obtiene un conjunto predeterminado de propiedades de objetos de grupo. Las propiedades utilizan el parámetro Propiedades. Para obtener más información sobre cómo determinar las propiedades de los objetos de grupo, consulte la descripción del parámetro Propiedades.

Ejemplos

Ejemplo 1: Obtener un grupo por cuenta SAM name

Este comando obtiene el grupo con el nombre de cuenta SAM Administrators.

Ejemplo 2: Obtenga un grupo por SID

Este comando obtiene el grupo con SID S -1-5-32-544 y el miembro de propiedad.

Ejemplo 3: Obtenga un grupo y filtre los resultados

Este El comando obtiene todos los grupos que tienen una categoría de grupo de seguridad pero que no tienen un alcance de grupo de DomainLocal.

Ejemplo 4: obtener un grupo de una base de búsqueda específica y filtrar los resultados

Este comando obtiene todos los grupos DomainLocal de la A Partición ppNC de la instancia de AD LDS.

Parámetros

-AuthType

Especifica el método de autenticación a utilizar. Los valores aceptables para este parámetro son:

  • Negociar o 0
  • Básico o 1

El método de autenticación predeterminado es Negociar.

Un método seguro Se requiere una conexión de capa de sockets (SSL) para el método de autenticación básico.

Tipo: ADAuthType
Valores aceptados: Negociar, Básico
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso

-Credential

Especifica las credenciales de la cuenta de usuario que se utilizarán para realizar esta tarea. Las credenciales predeterminadas son las del usuario que ha iniciado sesión actualmente, a menos que el cmdlet se ejecute desde un Active Direct. módulo ory para la unidad del proveedor de Windows PowerShell. Si el cmdlet se ejecuta desde dicha unidad de proveedor, la cuenta asociada con la unidad es la predeterminada.

Para especificar este parámetro, puede escribir un nombre de usuario, como Usuario1 o Dominio01 \ Usuario01 o puede especificar un objeto PSCredential.Si especifica un nombre de usuario para este parámetro, el cmdlet solicita una contraseña.

También puede crear un objeto PSCredential mediante un script o mediante mediante el cmdlet Get-Credential. Luego, puede establecer el parámetro Credential en el objeto PSCredential.

Si las credenciales activas no tienen permiso de nivel de directorio para realizar la tarea, el módulo de Active Directory para Windows PowerShell devuelve un error de terminación.

Tipo: PSCredential
Posición : Nombrado
Valor predeterminado: Ninguno
Aceptar canalización entrada: Falso
Aceptar caracteres comodín: Falso
-Filter
-Identity

Especifica un objeto de grupo de Active Directory proporcionando uno de los siguientes valores. El identificador entre paréntesis es el nombre de visualización LDAP para el atributo. Los valores aceptables para este parámetro son:

  • Un nombre distinguido
  • A GUID (objectGUID)
  • Un identificador de seguridad (objectSid)
  • Un nombre de cuenta de administrador de cuentas de seguridad (sAMAccountName)

El cmdlet busca el nombre predeterminado contexto o partición para encontrar el objeto. Si se encuentran dos o más objetos, el cmdlet devuelve un error no final.

Este parámetro también puede obtener este objeto a través de la canalización o puede establecer este parámetro en un instancia de objeto.

Tipo: ADGroup
Posición: 0
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Verdadero
Acepta caracteres comodín: Falso
-LDAPFilter

Especifica una cadena de consulta LDAP que se utiliza para filtrar objetos de Active Directory. Puede utilizar este parámetro para ejecutar sus consultas LDAP existentes. La sintaxis del parámetro admite la misma funcionalidad que la sintaxis LDAP. Para obtener más información, consulte la descripción del parámetro Filtro o escriba Get-Help about_ActiveDirectory_Filter.

Tipo: Cadena
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

-Pa rtition

Especifica el nombre distinguido de una partición de Active Directory. El nombre distinguido debe ser uno de los contextos de nomenclatura en el servidor de directorio actual. El cmdlet busca en esta partición para encontrar el objeto definido por la identidad

En muchos casos, se utiliza un valor predeterminado para el parámetro Partición si no se especifica ningún valor. Las reglas para determinar el valor predeterminado se dan a continuación. Tenga en cuenta que las reglas enumeradas primero se evalúan primero y una vez Se puede determinar el valor predeterminado, no se evalúan más reglas.

En entornos de Servicios de dominio de Active Directory (AD DS), se establece un valor predeterminado para Partición en los siguientes casos:

  • Si el parámetro Identity se establece en un nombre distinguido, el valor predeterminado de Partición se genera automáticamente a partir de este nombre distinguido.
  • Si ejecuta cmdlets desde una unidad de proveedor de Active Directory, el valor predeterminado de Partición es automáticamente generado a partir de la ruta actual en la unidad.
  • Si no se aplica ninguno de los casos anteriores, el valor predeterminado de Partición se establece en la partición predeterminada o el contexto de nomenclatura del dominio de destino.

En Active Directory Lightweight Directory Services (AD LDS), se establece un valor predeterminado para Partición en los siguientes casos:

  • Si el parámetro Identity se establece en un nombre distinguido, el valor predeterminado de Partición se genera automáticamente a partir de este nombre.
  • Si ejecuta cmdlets desde una unidad de proveedor de Active Directory, el valor predeterminado de Partición se genera automáticamente a partir de la ruta actual en la unidad.
  • Si la instancia de AD LDS de destino tiene una contexto de nomenclatura predeterminado, el valor predeterminado de Partición se establecerá en el contexto de nomenclatura predeterminado. Para especificar un contexto de nomenclatura predeterminado para un entorno AD LDS, establezca la propiedad msDS-defaultNamingContext del objeto de agente de servicio de directorio de Active Directory (nTDSDSA) para Instancia LDS.
  • Si ninguna de las aplicaciones de casos anteriores ly, el parámetro Partition no toma ningún valor predeterminado.
Tipo: String
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso
-Properties

Especifica las propiedades del objeto de salida para recuperar del servidor .Utilice este parámetro para recuperar propiedades que no están incluidas en el conjunto predeterminado.

Especifique las propiedades de este parámetro como una lista de nombres separados por comas. Para mostrar todos los atributos que están establecidos en el objeto, especificar * (asterisco).

Para especificar una propiedad extendida individual, use el nombre de la propiedad. Para propiedades que no son propiedades predeterminadas o extendidas, debe especificar el nombre de visualización LDAP del atributo.

Para recuperar propiedades y mostrarlas para un objeto ct, puede usar el cmdlet Get- * asociado con el objeto y pasar la salida al cmdlet Get-Member.

Tipo: Cadena
Alias: Propiedad
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso

-ResultPageSize

Especifica el número de objetos que se incluirán en una página para una consulta de AD DS.

El valor predeterminado es 256 objetos por página.

Tipo: Int32
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso
-ResultSetSize

Especifica el número máximo de objetos que se devolverán para una consulta de AD DS. Si desea recibir todos los objetos, establezca este parámetro en $ Null (valor nulo). Puede usar Ctrl + C para detener la consulta y el retorno de objetos.

El valor predeterminado es $ Null.

Tipo: Int32
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso
-SearchBase

Especifica una ruta de Active Directory para buscar bajo.

Cuando ejecuta un cmdlet desde una unidad de proveedor de Active Directory, el valor predeterminado de este parámetro es la ruta actual de la unidad.

Cuando ejecuta un cmdlet fuera de una Unidad de proveedor de Active Directory contra un destino de AD DS, el valor predeterminado de este parámetro es el contexto de nomenclatura predeterminado del dominio de destino.

Cuando ejecuta un cmdlet fuera de una unidad de proveedor de Active Directory contra un destino de AD LDS , el valor predeterminado es el contexto de nomenclatura predeterminado de la instancia de LDS de destino, si se ha especificado uno mediante la configuración de la propiedad msDS-defaultNamingContext del objeto de agente de servicio de directorio de Active Directory (nTDSDSA) para la instancia de AD LDS. especificado para la instancia de AD LDS de destino, este parámetro no tiene un valor predeterminado.

Cuando el valor del parámetro SearchBase se establece en una cadena vacía y está conectado a un puerto GC, se buscan todas las particiones. Si el valor del parámetro SearchBase se establece en un s vacío tring y no está conectado a un puerto GC, se produce un error.

Tipo: String
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso
-SearchScope

Especifica el alcance de una búsqueda de Active Directory. Los valores aceptables para este parámetro son:

  • Base o 0
  • OneLevel o 1
  • Subárbol o 2

A La consulta base busca solo la ruta u objeto actual. Una consulta de un nivel busca los hijos inmediatos de esa ruta u objeto. Una consulta de subárbol busca la ruta u objeto actual y todos los hijos de esa ruta u objeto.

Tipo: ADSearchScope
Valores aceptados: Base, OneLevel , Subárbol
Posición: N amed
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

-Server

Especifica la instancia de Servicios de dominio de Active Directory a la que conectarse, proporcionando uno de los siguientes valores para un nombre de dominio o servidor de directorio correspondiente. lo siguiente: Servicios de dominio ligero de Active Directory, Servicios de dominio de Active Directory o instancia de instantánea de Active Directory.

Especifique la instancia de Servicios de dominio de Active Directory de una de las siguientes formas:

Valores de nombre de dominio :

  • Nombre de dominio completo
  • Nombre NetBIOS

Valores del servidor de directorio:

  • Completamente nombre del servidor de directorio calificado
  • nombre NetBIOS
  • Nombre y puerto del servidor de directorio completamente calificado

El valor predeterminado para este parámetro está determinado por uno de lossiguientes métodos en el orden en que se enumeran:

  • Mediante el uso del valor del servidor de los objetos que pasan a través de la canalización
  • Mediante el uso de la información del servidor asociada con los servicios de dominio de Active Directory Unidad del proveedor de Windows PowerShell, cuando el cmdlet se ejecuta en esa unidad
  • Mediante el uso del dominio de la computadora que ejecuta Windows PowerShell
Tipo: Cadena
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso
-ShowMemberTimeToLive

Indica que este cmdlet muestra valores de tiempo de vida (TTL) para los miembros del grupo.

Tipo: SwitchParameter
Posición: Con nombre
Valor predeterminado: Ninguno
Aceptar entrada de canalización: Falso
Aceptar caracteres comodín: Falso

Entradas

Ninguna o Microsoft.ActiveDirectory.Management.ADGroup

El parámetro Identity recibe un objeto de grupo.

Salidas

ADGroup

Devuelve uno o más objetos de grupo.

El cmdlet Get-ADGroup devuelve un conjunto predeterminado de valores de propiedad de ADGroup. Para recuperar propiedades ADGroup adicionales , use el parámetro Propiedades.

Para ver las propiedades de un objeto ADGroup, vea los siguientes ejemplos. Para ejecutar estos ejemplos, reemplace < group > con un identificador de grupo como Administradores.

Para obtener una lista del conjunto predeterminado de propiedades de un objeto ADGroup, utilice el siguiente comando siguiente:

Get-ADGroup < grupo > | Get-Member

Para obtener una lista de todas las propiedades de un objeto ADGroup, use el siguiente comando:

Get-ADGroup < grupo > -Properties * | Get-Member

  • New-ADGroup
  • Remove-ADGroup
  • Set-ADGroup

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *