Microsoft Graph PowerShell ile Kullanıcı Oluşturmak İçin New-MgUser Nasıl Kullanılır

New-MgUser cmdlet'i, Azure Active Directory'nizde yeni kullanıcılar oluşturmanıza olanak tanır. Tahmin edebileceğiniz gibi, yeni bir kullanıcı oluştururken ayarlayabileceğiniz birçok farklı özellik vardır ve bunların tümü Microsoft Graph PowerShell referans belgelerinde bulunabilir.

Bu eğitimde size Microsoft Graph PowerShell'i kullanarak nasıl yeni bir kullanıcı (ve birden fazla yeni kullanıcı) oluşturulacağını göstereceğim.

Önkoşullar

Bu eğitim için Microsoft Graph PowerShell modülünün kurulu olması gerekir. Henüz yüklemediyseniz Microsoft Graph PowerShell Modülü Nasıl Kurulur ile ilgili rehberime göz atın. Kılavuz ayrıca, güncellemenizin üzerinden uzun bir süre geçmişse modülünüzü en son sürüme nasıl güncelleyeceğiniz konusunda da size yol gösterecektir.

Yeni MgUser cmdlet'i hakkında

New-MgUser cmdlet'i Microsoft.Graph.Users modülünde bulunabilir; bu nedenle, komutu kullanmak için modülün öncelikle geçerli PowerShell oturumuna aktarılması gerekir. Bu, aşağıdaki komutla yapılabilir:

Import-Module Microsoft.Graph.Users

Bu cmdlet'in kullanımını kapsayan birçok farklı izin de vardır; en az izin veren User.ReadWrite.All'dir.

New-MgUser cmdlet'ini kullanmanıza olanak tanıyan izinleri görüntülemek için aşağıdaki komutu kullanabilirsiniz:

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

Çıktınız aşağıdaki gibi görünecek:

Yeni bir kullanıcı oluşturmak için hangi özellikler gereklidir?

Azure Active Directory'nizde (veya Microsoft 365) yeni bir kullanıcı hesabı oluştururken, kullanıcı oluşturma isteğinizin başarılı olması için tanımlamanız gereken minimum miktarda bilgi vardır.

New-MgUser cmdlet'i kullanılırken aşağıdaki Öznitelikler her zaman tanımlanmalıdır:

  • -DisplayName “Dize”
  • -PasswordProfile @{HashTable}
  • -AccountEnabled
  • -MailNickName“Dize”
  • -UserPrincipalName“String”

Şifre profili nasıl oluşturulur

Yeni kullanıcı oluşturmanın önemli bir kısmı uygulanacak şifre ayarlarının tanımlanmasıdır. Bu şifre ayarları yukarıda da gördüğünüz gibi bir hash tablosu içerisinde tanımlıdır.

Aşağıda örneğini görebileceğiniz hash tablosunda tanımlayabileceğiniz 3 ayar bulunmaktadır:

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

Şifre - Bu, hesap oluşturulduğunda kullanıcıya atanan şifredir. Bu, karma tablosunda gerekli olan tek değer çiftidir; bu, diğer ayarların isteğe bağlı ancak tavsiye edildiği anlamına gelir.

ForceChangePasswordNextSignIn - Bu değer $true olarak ayarlandığında, kullanıcı bir sonraki oturum açtığında şifresini güncellemeye zorlanır. Bu seçenek belirtilmezse varsayılan ayar $false olur.

ForceChangePasswordNextSignInWithMfa - Bu, yukarıdaki ayarlarla aynıdır, ancak bu sefer kullanıcı, şifresini değiştirmesi istenmeden önce MFA kaydını veya bir sorgulamayı tamamlamaya zorlanacaktır. Bu seçenek belirtilmezse varsayılan ayar $false olur.

Microsoft Graph PowerShell ile yeni bir kullanıcı nasıl oluşturulur?

New-MgUser cmdlet'ini kullanarak yeni kullanıcınızı oluşturmak için aşağıdaki örneği kopyalayabilir ve her alıntı arasındaki bilgileri değiştirebilirsiniz.

Connect-MgGraph -scope User.ReadWrite.All

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

Komut dosyasının tamamını kopyalayıp yapıştırmak için aşağıdakileri kullanabilirsiniz:

##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'den birden fazla kullanıcı nasıl oluşturulur?

Çoğu zaman aynı anda birden fazla yeni kullanıcı hesabı oluşturmanız gerektiğini görebilirsiniz. Bunu yapmanın en basit yolu, işe alım veya benzeri departmandan size bir excel dosyası veya CSV dosyası halinde istenen tüm kullanıcı bilgilerini içeren bir kullanıcı listesi sağlamasını istemektir.

GitHub'umda bulunan örnek CSV dosyasını burada kullanabilirsiniz.

Aşağıda bir CSV'den Microsoft Graph PowerShell ile birden fazla kullanıcı oluşturmak için örnek betiğin tamamını bulacaksınız.

##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
}

Artık kullanıcı hesaplarınızı oluşturdunuz, ayrıca şunlara da göz atabilirsiniz:

  • Microsoft Graph PowerShell ile Kullanıcı Lisansları Nasıl Atılır
  • Get-MgUser'ı Microsoft Graph PowerShell ile Kullanma

İlgili makaleler