Get-CMUser

Модуль:
ConfigurationManager Module

Возвращает пользователя Configuration Manager.

Синтаксис

ByName (По умолчанию) 

Get-CMUser
    [-Name <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByIdMandatory 

Get-CMUser
    -CollectionId <String>
    [-Name <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByNameMandatory 

Get-CMUser
    -CollectionName <String>
    [-Name <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByValueMandatory 

Get-CMUser
    -InputObject <IResultObject>
    [-Name <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

ById 

Get-CMUser
    -ResourceId <Int32>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

Описание

Командлет Get-CMUser получает Configuration Manager объект пользователя. По умолчанию он запрашивает коллекцию Все пользователи . Параметры CollectionID или CollectionName можно использовать для изменения коллекции для запроса. В зависимости от доступа на основе ролей на сайте может потребоваться использовать один из этих других параметров. Например, если у вас нет доступа к SMS00002 (коллекция All Users), то по умолчанию этот командлет возвращает ноль результатов.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Получение пользователя по имени

PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\username01"

Эта команда возвращает пользователя с именем username01 из коллекции Все пользователи.

Пример 2. Передача коллекции и получение пользователя из нее

PS XYZ:\> Get-CMCollection -Name "All Users" | Get-CMUser -Name "Contoso\testuser01"

Эта команда получает объект коллекции с именем All Users и использует оператор конвейера для передачи объекта Get-CMUser, который получает пользователя с именем testuser01 из объекта коллекции.

Параметры

-CollectionId

Указывает идентификатор коллекции пользователей.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SearchByIdMandatory
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CollectionName

Указывает имя коллекции пользователей.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SearchByNameMandatory
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InputObject

Указывает объект коллекции. Чтобы получить объект коллекции, используйте командлет Get-CMCollection .

Свойства параметров

Тип:IResultObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Collection

Наборы параметров

SearchByValueMandatory
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Указывает имя пользователя.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

ByName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
SearchByIdMandatory
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
SearchByNameMandatory
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
SearchByValueMandatory
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceId

Указывает идентификатор ресурса пользователя.

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Id, UserId

Наборы параметров

ById
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject

IResultObject