【PowerShell】Windowsのローカルユーザー、グループを大量に作成する

#初めに
私の現場ではまれに各Windows Serverでローカルユーザを作成して、グループへ所属させるような業務が発生する。
少数であればGUIでポチポチ設定してもよいけれど大量に作成する必要があったり、少人数の作成でも頻繁に依頼があると面倒なので
PowerShellでCSVからユーザ設定を読み込んで一括作成したい。

#環境

powershell

$PSVersionTable

Name                           Value                                                                                  
----                           -----                                                                                  
PSVersion                      5.1.19041.1                                                                            
PSEdition                      Desktop 
...


Get-Module -Name "Microsoft.PowerShell.LocalAccounts"

ModuleType Version    Name                                ExportedCommands                                            
---------- -------    ----                                ----------------                                            
Binary     1.0.0.0    Microsoft.PowerShell.LocalAccounts  {Add-LocalGroupMember, Disable-LocalUser, Enable-LocalUse...

Windows Server環境ではなく個人PCのWindows10 Homeで実施していますがWindows Server 2016以降であればデフォルトで動作するはず。

##使用できるコマンドレット一覧

powershell

#グループへ追加する
Add-LocalGroupMember

#有効化無効化
Disable-LocalUser
Enable-LocalUser

#情報取得
Get-LocalGroup
Get-LocalGroupMember
Get-LocalUser

#新規作成
New-LocalGroup
New-LocalUser

#削除
Remove-LocalGroup
Remove-LocalGroupMember
Remove-LocalUser

#名前変更
Rename-LocalGroup
Rename-LocalUser

#設定変更
Set-LocalGroup
Set-LocalUser

##注意
Get-で始まるコマンドレット以外はすべて管理者権限での実行が必要。

#ユーザ作成
ユーザの作成はNew-LocalUserコマンドレットを使用する。
オプションでユーザの各種プロパティを設定可能。公式ドキュメントはこちら

powershell

New-LocalUser
   [-AccountExpires <DateTime>]	#有効期限
   [-AccountNeverExpires]		#有効期限なし
   [-Description <String>]		#説明
   [-Disabled]					#無効化
   [-FullName <String>]			#フルネーム
   [-Name] <String>				#ユーザ名
   [-Password] <SecureString>	#パスワード
   [-NoPassword]				#パスワードなし
   [-PasswordNeverExpires]		#パスワードを無期限
   [-UserMayNotChangePassword]	#ユーザによってパスワードを変更させない
   [-WhatIf]					#実行せずに結果を確認する
   [-Confirm]					#確認を要求する
   [<CommonParameters>]			

New-LocalUserで作成されたユーザはどのグループにも所属していない。（Usersグループにも所属していない）
また、-passwordにプレーンテキストを渡すと下記エラーとなるのでコマンドでSystem.Security.SecureString型へ変換する必要がある。

実行例

> New-LocalUser -Name 'TEST_USER' -Password 'P@ssw0rd'

New-LocalUser : パラメーター 'Password' をバインドできません。"P@ssw0rd" の値を "System.String" 型から "System.Security.SecureString" 型に変換できま
せん。
発生場所 行:1 文字:43
+ New-LocalUser -Name 'TEST_USER' -Password 'P@ssw0rd'
+                                           ~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [New-LocalUser]、ParameterBindingException
    + FullyQualifiedErrorId : CannotConvertArgumentNoMessage,Microsoft.PowerShell.Commands.NewLocalUserCommand
 

###System.String型をSystem.Security.SecureString型へ変換するコマンド

powershell

convertto-securestring  'P@ssw0rd' -AsPlainText -Force

###使用例

powershell

#プレーンテキストを暗号化
$password = convertto-securestring 'PASSWORD' -AsPlainText -Force

#ユーザ名TEST_USERを作成
New-LocalUser -Name 'TEST_USER' `
    -Password $password `
    -Description 'テスト用のユーザです' `
    -AccountNeverExpires

#ユーザ設定変更

powershell

Set-LocalUser -Name TEST_USER -Description 'テスト用のユーザです2020/10/01に破棄'

#グループを作成する

powershell

#グループ名TEST_GROUPを作成
New-LocalGroup -Name 'TEST_GROUP'

#グループへ追加する

powershell

#TEST_GROUPグループへTEST_USERを追加
Add-LocalGroupMember -Group 'TEST_GROUP' -Member 'TEST_USER'

#CSVからユーザ設定を読み込んで一括で作成するスクリプト(例)

##CSV
作成するユーザの各種設定を記載したCSVを用意する。※文字コードはSJIS
ファイル名は「作成するユーザ設定.csv」としています。

見出し

"ユーザ名","パスワード","説明","無期限(TRUE/FALSE)"

##スクリプト
下記を実行するとCSVをもとにユーザを一括で作成します。
スクリプトと同一フォルダにある「作成するユーザ設定.csv」を読み込みます。

まとめてローカルユーザ作成.ps1

#$PSScriptRootはカレントファルダパス
$csv = Import-Csv -Encoding Default -Path (Join-Path $PSScriptRoot "作成するユーザ設定.csv")

for($i=0; $i -lt $csv.Length; $i++){
    #ユーザー作成
    $Name = $csv.'ユーザ名'[$i]
    New-LocalUser -Name $Name `
        -Password (convertto-securestring $csv.'パスワード'[$i] -AsPlainText -Force) `
        -Description $csv.'説明'[$i]
    
    #CSVの「無期限(TRUE/FALSE)」列にTRUEと記載されている場合実行
    if($csv.'無期限(TRUE/FALSE)'[$i] -eq 'TRUE'){
        Set-LocalUser -Name $Name -AccountNeverExpires
    }

    #Usersグループへ追加する
    Add-LocalGroupMember -Group Users -Member $Name
}

##試しに1000ユーザ作成してみる
###コマンドでCSVを作成する

powershell

[String[]]$array = @('"ユーザ名","パスワード","説明","無期限(TRUE/FALSE)"')
1..1000 | %{ $array += '"TEST_USER' + $_ + '","P@ssw0rd",,' }

$csvPath = Join-Path $PSScriptRoot "作成するユーザ設定.csv"
Add-Content -Encoding Default -Value $array -Path $csvPath

###実行結果
1000ユーザ作成までにかかった時間はこんな感じ。
グループ追加もしてるとはいえ、そこそこかかる・・。

powershell

Measure-Command { .\まとめてローカルユーザ作成.ps1 }

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 56
Milliseconds      : 63
Ticks             : 560634428
TotalDays         : 0.000648882439814815
TotalHours        : 0.0155731785555556
TotalMinutes      : 0.934390713333333
TotalSeconds      : 56.0634428
TotalMilliseconds : 56063.4428

以上です。

#参考

• Microsoft Docs 公式ドキュメント
• PowerShellでローカルユーザー(アカウント)やグループの追加・変更・削除を行う方法
• powershellでローカルユーザを追加 - Qiita