Получает одного или нескольких пользователей Active Directory.
СИНТАКСИС
Get-ADUser -Filter [-ResultPageSize ] [-ResultSetSize ] [-SearchBase ] [-SearchScope ] [-SearchScope ] [-AuthType ] [-Credential ] [-Partition ] [-Properties ] [-Server ] [ ]
Get-ADUser [-Identity] [-AuthType ] [-Credential ] [-Partition ] [-Properties ] [-Server ] [ ]
Get-ADUser -LDAPFilter [-ResultPageSize ] [-ResultSetSize ] [-SearchBase ] [-SearchScope ] [-AuthType ] [-Credential ] [-Partition ] [-Properties ] [-Server ] [ ]
ОПИСАНИЕ
Командлет Get-ADUser получает объект пользователя или выполняет поиск для получения нескольких объектов пользователей.
Параметр Identity определяет получаемого пользователя Active Directory. Пользователя можно идентифицировать по различающемуся имени (DN), значению GUID, идентификатору безопасности (SID), имени учетной записи SAM или по имени. Можно также присвоить этому параметру переменную объекта пользователя, например $, или передать в параметр Identity объект пользователя по конвейеру.
«pip» не является внутренней или внешней командой, исполняемой программой или пакетным файлом.
Для поиска и получения нескольких пользователей используйте параметр Filter или LDAPFilter. В параметре Filter для написания строк запросов к Active Directory используется язык выражений PowerShell. Синтаксис языка выражений PowerShell поддерживает широкие возможности преобразования типов для значений, принимаемых параметром Filter. Дополнительные сведения о синтаксисе параметра Filter см. в разделе about_ActiveDirectory_Filter. Если существуют строки запроса LDAP, можно использовать параметр LDAPFilter.
Этот командлет получает набор свойств объекта пользователя, заданный по умолчанию. Чтобы получить дополнительные свойства, используйте параметр Properties. Дополнительные сведения об определении свойств объектов пользователей см. в описании параметра Properties.
ПАРАМЕТРЫ
-AuthType
Задает используемый метод проверки подлинности. Возможные значения параметра:
Negotiate или 0
Basic или 1
По умолчанию используется метод проверки подлинности Negotiate.
Для метода проверки подлинности Basic требуется SSL-соединение.
В следующем примере показано, как присвоить этому параметру значение Basic.
PowerShell
-AuthType Basic
Возможные значения параметра:
| Необходимость параметров | Не обязательный параметр |
| Позиция | именованный параметр |
| Значение по умолчанию | Microsoft.ActiveDirectory.Management.AuthType.Negotiate |
| Принимать входные данные конвейера | false |
| Принимать подстановочные знаки | false |
-Credential
Задает параметры учетной записи пользователя для выполнения задачи. Учетными данными по умолчанию являются учетные данные текущего пользователя, вошедшего в систему, если только командлет не выполняется с диска поставщика Active Directory PowerShell. Если командлет выполняется с такого диска поставщика, в качестве значения по умолчанию используется учетная запись, связанная с диском.
Имя не распознано как имя командлета
Чтобы задать этот параметр, можно ввести имя пользователя, например «User1» или «Domain01User01», либо указать объект PSCredential. Если для этого параметра задать имя пользователя, командлет запросит пароль.
Кроме того, объект PSCredential можно создать с помощью скрипта или командлета Get-Credential. Затем параметру Credential можно присвоить значение объекта PSCredential. В следующем примере показано как создать учетные данные.
PowerShell
$AdminCredentials = Get-Credential «Domain01User01»
Ниже показано, как присвоить параметру Credential эти учетные данные.
PowerShell
-Credential $AdminCredentials
Если для используемых учетных данных не установлены полномочия на уровне каталога для выполнения задачи, Active Directory PowerShell вернет прерывающую ошибку.
| Необходимость параметров | Не обязательный параметр |
| Позиция | именованный параметр |
| Значение по умолчанию | |
| Принимать входные данные конвейера | false |
| Принимать подстановочные знаки | false |
-Filter
Задает строку запроса, получающую объекты Active Directory. Эта строка использует синтаксис языка выражений PowerShell. Синтаксис языка выражений PowerShell поддерживает широкие возможности преобразования типов для значений, принимаемых параметром Filter. В синтаксисе используется порядковое представление, что означает, что оператор помещается между операндом и значением. Дополнительные сведения о параметре Filter см. в разделе about_ActiveDirectory_Filter.
Синтаксис:
В следующем синтаксисе демонстрации использования языка выражений PowerShell для данного параметра используется форма Бэкуса-Наура.
::= «-eq» | «-le» | «-ge» | «-ne» | «-lt» | «-gt»| «-approx» | «-bor» | «-band» | «-recursivematch» | «-like» | «-notlike»
Список поддерживаемых типов для значения см. в разделе ActiveDirectory_ObjectModel.
В следующих примерах показано, как использовать этот синтаксис в командлетах Active Directory.
Чтобы получить все объекты типа, указанного с помощью командлета, используйте подстановочный знак «звездочка».
Объекты всех пользователей:
PowerShell
Get-ADUser -Filter *
-или-
Объекты всех компьютеров:
PowerShell
Get-ADComputer -Filter *
Чтобы получить объекты всех пользователей, имеющие атрибут сообщения электронной почты, воспользуйтесь одной из следующих команд:
PowerShell
Get-ADUser -Filter < EmailAddress -like «*» >
PowerShell
Get-ADUser -Filter < mail -like «*» >
PowerShell
Get-ADObject -Filter < ( mail -like «*» ) -and ( ObjectClass -eq «user» ) >
Примечание. Подстановочные знаки PowerShell, отличные от «*», например «?», не поддерживаются синтаксисом параметра Filter.
Чтобы получить объекты всех пользователей с фамилией Корепин и атрибутом электронной почты, воспользуйтесь одной из следующих команд:
PowerShell
Get-ADUser -filter < ( EmailAddress -like «*» ) -and ( Surname -eq «korepin» ) >
PowerShell
Get-ADUser -filter < ( mail -eq «*» ) -and ( sn -eq «Korepin» ) >
Чтобы получить объекты всех пользователей, которые не выполняли вход в систему с 1 января 2007 г., воспользуйтесь одной из следующих команд:
PowerShell
$logonDate = New-Object System . DateTime ( 2007 , 1 , 1 )
Get-ADUser -filter < lastLogon -le $logonDate >
Чтобы получить все группы, для которых категория имеет значение Security, а область — Global, воспользуйтесь одной из следующих команд:
PowerShell
Get-ADGroup -filter < GroupCategory -eq «Security» -and GroupScope -eq «Global» >
PowerShell
Get-ADGroup -filter < GroupType -band 0x80000000 >
Примечание. Чтобы сформировать запрос с использованием строк запроса LDAP, используйте параметр LDAPFilter.
| Необходимость парaметров | Обязательный параметр |
| Позиция | именованный параметр |
| Значение по умолчанию | |
| Принимать входные данные конвейера | false |
| Принимать подстановочные знаки | false |
-Identity
Задает объект пользователя Active Directory, указывая одно из следующих значений свойств. Идентификатор в скобках представляет собой отображаемое имя LDAP атрибута.
Различающееся имя
Пример:CN=SaraDavis,CN=Europe,CN=Users,DC=corp,DC=contoso,DC=com
GUID (objectGUID)
Пример: 599c3d2e-f72d-4d20-8a88-030d99495f20
Идентификатор безопасности (objectSid)
Пример: S-1-5-21-3165297888-301567370-576410423-1103
Имя учетной записи SAM (sAMAccountName)
Пример: saradavis
Командлет ищет объект в пределах контекста или раздела именования по умолчанию. Если найдено несколько объектов, командлет вернет непрерывающую ошибку.
Этот параметр также может принимать данный объект по конвейеру, либо можно присваивать этому параметру экземпляр объекта.
В данном примере показано, как присвоить этому параметру различающееся имя.
PowerShell
-Identity «CN=InnaOzhogina,CN=Europe,CN=Users,DC=corp,DC=contoso,DC=com»
В данном примере показано, как присвоить этому параметру экземпляр объекта пользователя с именем «userInstance».
PowerShell
-Identity $userInstance
| Необходимость парaметров | Обязательный параметр |
| Позиция | 1 |
| Значение по умолчанию | |
| Принимать входные данные конвейера | true (ByValue) |
| Принимать подстановочные знаки | false |
-LDAPFilter
Задает строку запроса LDAP, которая используется для фильтрации объектов Active Directory. Этот параметр можно использовать для выполнения существующих запросов LDAP. Синтаксис параметра Filter поддерживает те же функции, что и синтаксис LDAP. Дополнительные сведения см. в описании параметра Filter и в разделе about_ActiveDirectory_Filter.
В следующем примере показано, как задать этот параметр так, чтобы искать все объекты, имена которых начинаются на «inna», в подразделении, определяемом параметром SearchBase.
PowerShell
-LDAPFilter «(name=inna*)» -SearchScope Subtree -SearchBase «DC=NA,DC=fabrikam,DC=com»
| Необходимость парaметров | Обязательный параметр |
| Позиция | именованный параметр |
| Значение по умолчанию | |
| Принимать входные данные конвейера | false |
| Принимать подстановочные знаки | false |
-Partition
Задает различающееся имя раздела Active Directory. Различающееся имя должно являться одним из контекстов именования текущего сервера каталогов. Командлет ищет в этом разделе объект, заданный параметром Identity.
В следующих двух примерах показано, как задать значение этого параметра.
PowerShell
-Partition «CN=Configuration,DC=EUROPE,DC=TEST,DC=CONTOSO,DC=COM»
PowerShell
-Partition «CN=Schema,CN=Configuration,DC=EUROPE,DC=TEST,DC=CONTOSO,DC=COM»
Во многих случаях, если значение параметра Partition не указано, для него будет использоваться Значение по умолчанию,.Правила определения значения по умолчанию представлены ниже.Обратите внимание, что правила, указанные первыми, анализируются также первыми, и после определения значения по умолчанию никакие другие правила не рассматриваются.
В средах доменных служб Active Directory Значение по умолчанию, параметра Partition будет установлено в следующих случаях.- Если в качестве значения параметра Identity установлено различающееся имя, для формирования значения по умолчанию параметра Partition автоматически используется это различающееся имя.
— При запуске командлетов с диска поставщика Active Directory для формирования значения по умолчанию параметра Partition автоматически используется текущий путь на диске.
— Если ни один из представленных выше вариантов не применим, в качестве значения по умолчанию параметра Partition будет использоваться раздел по умолчанию или контекст именования целевого домена.
В средах AD LDS Значение по умолчанию, параметра Partition будет установлено в следующих случаях.
— Если в качестве значения параметра Identity установлено различающееся имя, для формирования значения по умолчанию параметра Partition автоматически используется это различающееся имя.
— При запуске командлетов с диска поставщика Active Directory для формирования значения по умолчанию параметра Partition автоматически используется текущий путь на диске.
— Если для целевого экземпляра AD LDS существует контекст именования по умолчанию, в качестве значения по умолчанию параметра Partition будет использоваться этот контекст именования.Чтобы задать контекст именования по умолчанию для среды AD LDS, задайте значение свойства msDS-defaultNamingContext объекта агента служб каталогов (DSA) Active Directory (nTDSDSA) для экземпляра AD LDS.
— Если ни один из представленных выше вариантов не применим, для параметра Partition не будет использоваться Значение по умолчанию,.
| Необходимость параметров | Не обязательный параметр |
| Позиция | именованный параметр |
| Значение по умолчанию | |
| Принимать входные данные конвейера | false |
| Принимать подстановочные знаки | false |
-Properties
Задает свойства выходного объекта для получения с сервера. Этот параметр служит для извлечения свойств, отсутствующих в наборе по умолчанию.
Задайте свойства этого параметра в виде разделенного запятыми списка имен. Чтобы отобразить все заданные для объекта атрибуты, укажите звездочку (*).
Чтобы задать отдельное расширенное свойство, воспользуйтесь именем этого свойства. Для свойств, которые не являются свойствами по умолчанию или расширенными свойствами, необходимо указать отображаемое имя LDAP атрибута.
Чтобы получить и отобразить свойства объекта, можно воспользоваться связанным с объектом командлетом Get-* и передать результаты его выполнения в командлет Get-Member. В следующих примерах показано, как получить свойства группы на примере объекта группы «Администраторы».
Источник: coolcode.ru
Термин Get-ADUser не распознается как имя командлета.
Я использовал следующий запрос, чтобы перечислить пользователей на сервере Windows 2008, но не смог и получил следующую ошибку.
$server=’client-pc-1′;$pwd= convertto-securestring ‘password$’ -asplaintext — force;$cred=new-object -typename System.Management.Automation.PSCredential -argumentlist ‘Administrator’,$pwd; invoke-command -computername $server -credential $cred -scriptblock Get-ADUser -Filter (enabled -ne $true)>
Исключение приведено ниже . Может ли кто-нибудь помочь мне решить эту проблему?
The term ‘Get-ADUser’ is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again. + CategoryInfo : ObjectNotFound: (Get-ADUser:String) [], CommandNotFoundException + FullyQualifiedErrorId : CommandNotFoundException
Если присутствует модуль ActiveDirectory, добавьте
import-module activedirectory
перед вашим кодом.
Чтобы проверить, существует ли, попробуйте:
get-module -listavailable
Модуль ActiveDirectory по умолчанию присутствует в Windows Server 2008 R2, установите его следующим образом:
Import-Module ServerManager Add-WindowsFeature RSAT-AD-PowerShell
Чтобы он работал, вам нужен хотя бы один DC в домене, например Windows 2008 R2, и на нем установлены веб-службы Active Directory (ADWS).
Для Windows Server 2008 читайте здесь , как установить его
Источник: qastack.ru
Ошибка при вызове командлета Get-WmiObject в PowerShell
Читатель моего сайта пожаловался на неработающий пример сценария PowerShell, в котором используется командлет Get-WmiObject . Разберёмся, что произошло.
Попытка вызвать командлет Get-WmiObject приводит к появлению следующей ошибки.
Get-WmiObject -Class Win32_OperatingSystem Get-WmiObject: The term ‘Get-WmiObject’ is not recognized as a name of a cmdlet, function, script file, or executable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
Описание ошибки прямо отвечает на вопрос о том, что произошло: Get-WmiObject не распознан как имя командлета, функции, файла сценария или исполняемой программы. Но если раньше всё работало, почему теперь командлет исчез, а сценарии, в которых он вызывается, больше не работают?
Произошло это потому что командлеты для работы с Windows Management Instrumentation (WMI) признаны устаревшими и отсутствуют в актуальной версии PowerShell Core, основанного на .NET Core. Замена для этих командлетов готовилась давно. Так в версии PowerShell 3.0 были добавлены командлеты для работы с Common Information Model (CIM), которые можно использовать не только в операционных системах семейства Microsoft Windows.
В качестве замены командлету Get-WmiObject теперь следует использовать командлет Get-CimInstance . При выполнении командлета на локальной машине, результат его работы аналогичен Get-WmiObject , но с другим форматированием вывода: Get-WmiObject выводит результат в виде списка, Get-CimInstance выводит результат в виде таблицы.
Закономерный вопрос: если командлет Get-WmiObject отсутствует в актуальной версии PowerShell, надо ли переписывать старые сценарии? Всё зависит от версии PowerShell в котором выполняется сценарий.
Windows 10 поставляется со встроенным PowerShell 5, в котором доступны командлеты Get-WmiObject и Get-CimInstance . Если планируется продолжать использовать сценарии со встроенной версией PowerShell на Windows 10, переписывать их, заменяя Get-WmiObject на Get-CimInstance , не требуется.
Однако при разработке новых сценариев, которые планируется использовать в будущем с новыми версиями PowerShell, следует использовать командлет Get-CimInstance .
Для того, чтобы привести вывод командлетов к одному виду, достаточно применить команды форматирования. Например Format-List .
Get-WmiObject -Class Win32_OperatingSystem Get-CimInstance -Class Win32_OperatingSystem | Format-List
Как видно на скриншоте, вывод результатов работы командлетов после применения команды форматирования стал идентичным.
Другие заметки
Как получить элементы с минимальным и максимальным значениями из массива на JavaScript
Когда в сценарии JavaScript надо получить элементы массива с минимальным или максимальным значениями, для этого не обязательно писать собственные функции или подключать сторонние библиотеки. Предлагаю рассмотреть два варианта решения стоящей задачи, в которых будут задействованы только стандартные возможности языка JavaScript.
Цвет 2023 года по версии Pantone
Следуя традиции, в конце 2022 года компания Pantone объявила трендовый цвет на 2023 год.
Сайт создан и поддерживается мною с целью сохранения и распространения в свободном доступе опубликованных на нём материалов. Авторство разработок, текстов и изображений, принадлежит мне, если иное не указано отдельно.
При копировании материалов с сайта, не забывайте о важности обратных ссылок.
Размещение обратной индексируемой ссылки показывает интерес к содержанию сайта, что мотивирует к работе над новыми материалами.
Источник: dimayakovlev.ru