Управление пользователями

elles-ws поддерживает создание, поиск, изменение и удаление пользователей, а также операции с паролем и состоянием учетной записи.

Поддерживаются следующие командлеты и сценарии:

Командлет Назначение

New-ADUser

Создание пользователя

Get-ADUser

Получение пользователя и поиск пользователей по фильтру

Set-ADUser

Изменение атрибутов пользователя, включая manager

Set-ADAccountPassword

Изменение или сброс пароля

Unlock-ADAccount

Разблокировка учетной записи

Disable-ADAccount

Отключение учетной записи

Enable-ADAccount

Включение учетной записи

Remove-ADUser

Удаление пользователя

Создание пользователя

Пример создания пользователя с основными и дополнительными атрибутами:

New-ADUser `
    -Name "Test User" `
    -SamAccountName testuser `
    -Description "ADWS test user" `
    -Office "Office 1" `
    -Server dc01.example.com:9389

New-ADUser поддерживает задание пароля через -AccountPassword, однако создание объекта и установка пароля являются различными операциями с точки зрения Active Directory и могут иметь разные результаты при нарушении парольной политики.

Подробнее: New-ADUser.

Получение пользователя

После создания объект можно проверить:

Get-ADUser -Identity testuser `
    -Properties Description,Office `
    -Server dc01.example.com:9389

Подробнее: Get-ADUser.

Изменение пользователя

Пример изменения обычных атрибутов:

Set-ADUser -Identity testuser `
    -DisplayName "Test User 01" `
    -Description "Updated through elles-ws" `
    -Server dc01.example.com:9389

Проверка:

Get-ADUser -Identity testuser `
    -Properties DisplayName,Description `
    -Server dc01.example.com:9389

Пример назначения ответственного для группы:

Set-ADUser -Identity testuser `
    -Manager manager1 `
    -Server dc01.example.com:9389

Проверка:

Get-ADUser -Identity testuser `
    -Properties Manager `
    -Server dc01.example.com:9389

Подробнее: Set-ADUser.

Изменение пароля

Для установки нового пароля используется Set-ADAccountPassword.

Например:

$Password = Read-Host "New password" -AsSecureString

Set-ADAccountPassword `
    -Identity testuser `
    -Reset `
    -NewPassword $Password `
    -Server dc01.example.com:9389

Параметр -Reset используется для административного сброса пароля; без него командлет также поддерживает сценарий смены пароля с указанием старого и нового значения.

Подробнее: Set-ADAccountPassword.

Состояние учетной записи

Поддерживается стандартный цикл:

Disable-ADAccount -Identity testuser `
    -Server dc01.example.com:9389

Enable-ADAccount -Identity testuser `
    -Server dc01.example.com:9389

Unlock-ADAccount -Identity testuser `
    -Server dc01.example.com:9389

Состояние можно проверить через Get-ADUser, запросив необходимые свойства.

Подробнее:

Поиск пользователей

Поиск всех пользователей:

Get-ADUser -Filter * `
    -Server dc01.example.com:9389

Пример поиска по атрибуту:

Get-ADUser `
    -Filter "SamAccountName -eq 'testuser'" `
    -Server dc01.example.com:9389

Подробнее: Get-ADUser.

Удаление пользователя

Пример удаления пользователя:

Remove-ADUser -Identity testuser `
    -Confirm:$false `
    -Server dc01.example.com:9389

Подробнее: Remove-ADUser.

Обновлено: