Get-CMAdministrativeUser

Obtenga un usuario administrativo.

Syntax

Get-CMAdministrativeUser
   [-Name <String>]
   [-RoleName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMAdministrativeUser
   -Id <String>
   [-RoleName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obtener uno o varios usuarios administrativos en Configuration Manager. Un usuario administrativo tiene un conjunto definido de permisos y puede ser miembro de uno o varios ámbitos o roles. Un usuario administrativo de Configuration Manager define un usuario o grupo local o de dominio. Para obtener más información sobre los roles de seguridad, vea Aspectos básicos de la administración basada en roles en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtener todos los usuarios administrativos

Este comando obtiene todos los usuarios administrativos. Muestra la salida como una tabla que muestra el nombre de la cuenta (LogonName), los roles de seguridad (RoleNames), los ámbitos de seguridad (CategoryNames) y las colecciones (CollectionNames).

Get-CMAdministrativeUser | Select-Object LogonName, RoleNames, CategoryNames, CollectionNames

Ejemplo 2: Obtención de un usuario administrativo por nombre

Este comando obtiene el usuario administrativo denominado jqpublic.

Get-CMAdministrativeUser -Name "Contoso\jqpublic"

Ejemplo 3: Obtención de todos los usuarios con ámbito específico

Este comando obtiene todos los usuarios administrativos con el ámbito Predeterminado y muestra los nombres de cuenta.

Get-CMAdministrativeUser | Where-Object { $_.CategoryNames -contains "Default" } | Select-Object LogonName

Ejemplo 4: Obtención de todos los usuarios con un rol específico

Este comando obtiene todos los usuarios administrativos con el rol Administrador completo y muestra los nombres de cuenta.

Get-CMAdministrativeUser -RoleName "Full Administrator" | Select-Object LogonName

Parámetros

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifique el identificador del usuario administrativo que se va a obtener. Este valor es la AdminID propiedad . Es un valor entero, por ejemplo 16777234.

Type:String
Aliases:AdminId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique el nombre del usuario administrativo que se va a obtener. Por ejemplo, domain\username o domain\groupname

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único
Type:String
Aliases:DisplayName, LogonName, UserName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-RoleName

Especifique una matriz de nombres de roles de seguridad. Este nombre puede ser para un rol integrado o personalizado. Para ver la lista de roles de seguridad integrados, consulte Roles de seguridad.

Type:String[]
Aliases:RoleNames
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Admin clase WMI de servidor.