El cmdlet Get-CMUser obtiene un objeto de usuario Configuration Manager. De forma predeterminada, consulta la colección Todos los usuarios . Puede usar los parámetros CollectionID o CollectionName para cambiar la colección que se va a consultar. En función del acceso basado en rol en el sitio, es posible que tenga que usar uno de estos otros parámetros. Por ejemplo, si no tiene acceso a SMS00002 (colección Todos los usuarios), este cmdlet devuelve de forma predeterminada cero resultados.
Nota:
Ejecute Configuration Manager cmdlets desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Obtención de un usuario por nombre
PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\username01"
Este comando obtiene el usuario denominado username01 de la colección Todos los usuarios.
Ejemplo 2: Pasar una colección y obtener un usuario de ella
PS XYZ:\> Get-CMCollection -Name "All Users" | Get-CMUser -Name "Contoso\testuser01"
Este comando obtiene el objeto de colección denominado Todos los usuarios y usa el operador de canalización para pasar el objeto a Get-CMUser, que obtiene el usuario denominado testuser01 del objeto de colección.
Parámetros
-CollectionId
Especifica el identificador de una colección de usuarios.
Propiedades de parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
SearchByIdMandatory
Posición:
Named
Obligatorio:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-CollectionName
Especifica el nombre de una colección de usuarios.
Propiedades de parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
SearchByNameMandatory
Posición:
Named
Obligatorio:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Propiedades de parámetro
Tipo:
SwitchParameter
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
(All)
Posición:
Named
Obligatorio:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Propiedades de parámetro
Tipo:
SwitchParameter
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
(All)
Posición:
Named
Obligatorio:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-InputObject
Especifica un objeto de colección.
Para obtener un objeto de colección, use el cmdlet Get-CMCollection .
Propiedades de parámetro
Tipo:
IResultObject
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Alias:
Colección
Conjuntos de parámetros
SearchByValueMandatory
Posición:
Named
Obligatorio:
True
Valor de la canalización:
True
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-Name
Especifica el nombre de un usuario.
Propiedades de parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
True
DontShow:
False
Conjuntos de parámetros
ByName
Posición:
Named
Obligatorio:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
SearchByIdMandatory
Posición:
Named
Obligatorio:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
SearchByNameMandatory
Posición:
Named
Obligatorio:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
SearchByValueMandatory
Posición:
Named
Obligatorio:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-ResourceId
Especifica el identificador de recurso de un usuario.
Propiedades de parámetro
Tipo:
Int32
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Alias:
Id, UserId
Conjuntos de parámetros
ById
Posición:
Named
Obligatorio:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.