ค้นหาเว็บไซต์

วิธีใช้ New-MgUser เพื่อสร้างผู้ใช้ด้วย Microsoft Graph PowerShell


New-MgUser cmdlet อนุญาตให้คุณสร้างผู้ใช้ใหม่ใน Azure Active Directory ของคุณ ดังที่คุณสามารถจินตนาการได้ มีแอตทริบิวต์ต่างๆ มากมายที่คุณสามารถตั้งค่าได้เมื่อสร้างผู้ใช้ใหม่ ซึ่งทั้งหมดนี้สามารถพบได้ในเอกสารอ้างอิงของ Microsoft Graph PowerShell

ในบทช่วยสอนนี้ ฉันจะแสดงวิธีสร้างผู้ใช้ใหม่ (และผู้ใช้ใหม่หลายราย) โดยใช้ Microsoft Graph PowerShell

ข้อกำหนดเบื้องต้น

สำหรับบทช่วยสอนนี้ คุณต้องติดตั้งโมดูล Microsoft Graph PowerShell หากคุณยังไม่ได้ติดตั้ง โปรดดูคำแนะนำของฉันเกี่ยวกับวิธีติดตั้ง Microsoft Graph PowerShell Module คู่มือนี้จะแนะนำวิธีอัปเดตโมดูลของคุณเป็นเวอร์ชันล่าสุดหากคุณไม่ได้อัปเดตมาระยะหนึ่งแล้ว

เกี่ยวกับ New-MgUser cmdlet

New-MgUser cmdlet สามารถพบได้ในโมดูล Microsoft.Graph.Users ดังนั้นในการใช้คำสั่ง จะต้องนำเข้าโมดูลไปยังเซสชัน PowerShell ปัจจุบันก่อน ซึ่งสามารถทำได้ด้วยคำสั่งต่อไปนี้:

Import-Module Microsoft.Graph.Users

นอกจากนี้ยังมีสิทธิ์ที่แตกต่างกันมากมายซึ่งครอบคลุมการใช้ cmdlet นี้ โดยสิทธิ์ขั้นต่ำคือ User.ReadWrite.All

คุณสามารถใช้คำสั่งต่อไปนี้เพื่อดูว่าสิทธิ์ใดบ้างที่ช่วยให้คุณใช้ New-MgUser cmdlet:

(Find-MgGraphCommand -command New-MgUser -apiversion v1.0 | `
select Permissions).permissions

ผลลัพธ์ของคุณจะมีลักษณะดังนี้:

คุณลักษณะใดที่จำเป็นสำหรับการสร้างผู้ใช้ใหม่

เมื่อสร้างบัญชีผู้ใช้ใหม่ใน Azure Active Directory ของคุณ (หรือ Microsoft 365) มีข้อมูลจำนวนขั้นต่ำที่คุณต้องกำหนด เพื่อให้คำขอสร้างผู้ใช้ของคุณสำเร็จ

ต้องกำหนดแอตทริบิวต์ต่อไปนี้เสมอเมื่อใช้ New-MgUser cmdlet:

  • -DisplayName “สตริง”
  • -PasswordProfile @{HashTable}
  • -เปิดใช้งานบัญชีแล้ว
  • -MailNickName“สตริง”
  • -UserPrincipalName“สตริง”

วิธีสร้างโปรไฟล์รหัสผ่าน

ส่วนสำคัญของการสร้างผู้ใช้ใหม่คือการกำหนดการตั้งค่ารหัสผ่านที่จะใช้ การตั้งค่ารหัสผ่านเหล่านี้ ดังที่คุณเห็นเขียนไว้ข้างต้น ได้รับการกำหนดไว้ภายในตารางแฮช

มีการตั้งค่า 3 แบบที่คุณสามารถกำหนดได้ภายในตารางแฮช ซึ่งคุณสามารถดูตัวอย่างด้านล่าง:

$PasswordProfile = @{
  Password = 'Helo123!'
  ForceChangePasswordNextSignIn = $true
  ForceChangePasswordNextSignInWithMfa = $true
}

รหัสผ่าน - นี่คือรหัสผ่านที่กำหนดให้กับผู้ใช้เมื่อสร้างบัญชี นี่เป็นคู่ค่าที่จำเป็นเพียงคู่เดียวในตารางแฮช ซึ่งหมายความว่าการตั้งค่าอื่นๆ เป็นทางเลือกแต่แนะนำ

ForceChangePasswordNextSignIn - เมื่อตั้งค่านี้เป็น $true เมื่อผู้ใช้ลงชื่อเข้าใช้ครั้งถัดไป ผู้ใช้จะถูกบังคับให้อัปเดตรหัสผ่าน หากไม่ได้ระบุตัวเลือกนี้ การตั้งค่าเริ่มต้นจะเป็น $false

ForceChangePasswordNextSignInWithMfa - นี่เป็นเช่นเดียวกับการตั้งค่าข้างต้น แต่ในครั้งนี้ ผู้ใช้จะถูกบังคับให้ลงทะเบียน MFA หรือทำการทดสอบก่อนที่จะถูกขอให้เปลี่ยนรหัสผ่าน หากไม่ได้ระบุตัวเลือกนี้ การตั้งค่าเริ่มต้นจะเป็น $false

วิธีสร้างผู้ใช้ใหม่ด้วย Microsoft Graph PowerShell

หากต้องการสร้างผู้ใช้ใหม่โดยใช้ New-MgUser cmdlet คุณสามารถคัดลอกตัวอย่างด้านล่างและเปลี่ยนแปลงข้อมูลระหว่างทุกเครื่องหมายคำพูด

Connect-MgGraph -scope User.ReadWrite.All

New-MgUser -DisplayName ‘New User’ -PasswordProfile $PassProfile `
-AccountEnabled -MailNickName ‘NewUser’ `
-UserPrincipalName '[email ’

หากต้องการคัดลอกและวางสคริปต์แบบเต็ม คุณสามารถใช้สิ่งต่อไปนี้:

##Import the Microsoft Graph Users module
Import-Module Microsoft.Graph.Users

##Connect to Microsoft Graph with the user read/write permission
Connect-MgGraph -scope User.ReadWrite.All

##Define the password profile settings within a hash table
$PasswordProfile = @{
    Password = "Helo123!"
    ForceChangePasswordNextSignIn = $true
    ForceChangePasswordNextSignInWithMfa = $true
}

##Create the new user account
New-MgUser -DisplayName "New User" -PasswordProfile $PasswordProfile `
-AccountEnabled -MailNickName "NewUser" `
-UserPrincipalName "[email "

วิธีสร้างผู้ใช้หลายรายจาก CSV

บ่อยครั้งคุณอาจพบว่าจำเป็นต้องสร้างบัญชีผู้ใช้ใหม่หลายบัญชีพร้อมกัน วิธีที่ง่ายที่สุดในการทำเช่นนี้คือขอให้แผนกการจ้างงานหรือแผนกที่คล้ายกันจัดเตรียมรายชื่อผู้ใช้พร้อมข้อมูลผู้ใช้ที่ต้องการทั้งหมดในไฟล์ Excel หรือไฟล์ CSV

คุณสามารถใช้ไฟล์ CSV ตัวอย่างที่ฉันมีใน GitHub ของฉันได้ที่นี่

ด้านล่างนี้คุณจะพบสคริปต์ตัวอย่างแบบเต็มเพื่อสร้างผู้ใช้หลายรายด้วย Microsoft Graph PowerShell จาก CSV

##Import the Microsoft Graph Users module
Import-Module Microsoft.Graph.Users

##Connect to Microsoft Graph with the user read/write permission
Connect-MgGraph -scope User.ReadWrite.All

##Import csv user list
$newusers = Import-CSV "C:\temp\newusers.csv"

##Define the password profile settings within a hash table
$PasswordProfile = @{
    Password = "Helo123!"
    ForceChangePasswordNextSignIn = $true
    ForceChangePasswordNextSignInWithMfa = $true
}

##Loop through and create each user
ForEach ($user in $newusers){
    New-MgUser -DisplayName $user.displayname `
    -PasswordProfile $PasswordProfile `
    -AccountEnabled `
    -MailNickName $user.mailnickname `
    -UserPrincipalName $user.userprincipalname `
    -Department $user.department `
    -JobTitle $user.jobtitle `
    -Mobile $user.mobile `
    -Birthday $user.birthday `
    -Country $user.country
}

ตอนนี้คุณได้สร้างบัญชีผู้ใช้แล้ว คุณสามารถดูได้ที่:

  • วิธีกำหนดสิทธิ์การใช้งานของผู้ใช้ด้วย Microsoft Graph PowerShell
  • วิธีใช้ Get-MgUser กับ Microsoft Graph PowerShell

บทความที่เกี่ยวข้อง