Bagikan melalui


New-AzureADUser

Membuat pengguna Azure AD.

Sintaks

New-AzureADUser
   [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   -AccountEnabled <Boolean>
   [-AgeGroup <String>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-CreationType <String>]
   [-Department <String>]
   -DisplayName <String>
   [-FacsimileTelephoneNumber <String>]
   [-GivenName <String>]
   [-IsCompromised <Boolean>]
   [-ImmutableId <String>]
   [-JobTitle <String>]
   [-MailNickName <String>]
   [-Mobile <String>]
   [-OtherMails <System.Collections.Generic.List`1[System.String]>]
   [-PasswordPolicies <String>]
   -PasswordProfile <PasswordProfile>
   [-PhysicalDeliveryOfficeName <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-ShowInAddressList <Boolean>]
   [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-TelephoneNumber <String>]
   [-UsageLocation <String>]
   [-UserPrincipalName <String>]
   [-UserState <String>]
   [-UserStateChangedOn <String>]
   [-UserType <String>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureADUser membuat pengguna di Azure Active Directory (Azure AD).

Contoh

Contoh 1: Membuat pengguna

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.com             Member

Perintah ini membuat pengguna baru.

Parameter

-AccountEnabled

Menunjukkan apakah akun pengguna diaktifkan.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

Ini menentukan grup usia pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

Menentukan kota pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

Ini menentukan nama perusahaan pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Menentukan negara atau wilayah pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreationType

Menunjukkan apakah akun pengguna adalah akun lokal untuk penyewa Azure Active Directory B2C.

Nilai yang mungkin adalah LocalAccount dan null. Saat membuat akun lokal, properti diperlukan dan Anda harus mengaturnya ke LocalAccount. Saat membuat akun kerja atau sekolah, jangan tentukan properti atau atur ke null.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Menentukan departemen pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Menentukan nama tampilan pengguna.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionProperty

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

Ini menentukan nomor telepon pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Menentukan nama yang diberikan pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmutableId

Properti ini digunakan untuk mengaitkan akun pengguna Active Directory lokal ke objek pengguna Azure AD mereka. Properti ini harus ditentukan saat membuat akun pengguna baru di Grafik jika Anda menggunakan domain federasi untuk properti userPrincipalName (UPN) pengguna.

Penting: Karakter $ dan _ tidak dapat digunakan saat menentukan properti ini.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

Menunjukkan apakah pengguna ini disusupi.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Menentukan jabatan pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Menentukan nama panggilan email pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

Menentukan nomor ponsel pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OtherMails

Daftar alamat email tambahan untuk pengguna. Misalnya, bob@contoso.com, Robert@fabrikam.com.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordPolicies

Menentukan kebijakan kata sandi untuk pengguna.

Nilai ini adalah enumerasi dengan satu nilai yang mungkin menjadi DisableStrongPassword, yang memungkinkan kata sandi yang lebih lemah daripada kebijakan default yang ditentukan. DisablePasswordExpiration juga dapat ditentukan. Keduanya dapat ditentukan bersama-sama; misalnya: "DisablePasswordExpiration, DisableStrongPassword".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordProfile

Menentukan profil kata sandi pengguna. Perhatikan bahwa jenis parameter untuk parameter ini adalah PasswordProfile. Untuk meneruskan parameter jenis ini, Anda harus terlebih dahulu;

  1. buat variabel di PowerShell dengan jenis tersebut:

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile

  1. Atur nilai kata sandi dalam variabel ini:

$PasswordProfile.Password = "\<Password\>"

  1. Akhirnya teruskan variabel ini ke cmdlet:

New-AzureADUser -PasswordProfile $PasswordProfile ...

Atribut lain yang dapat diatur dalam PasswordProfile adalah:

  • $PasswordProfile.EnforceChangePasswordPolicy - boolean yang menunjukkan bahwa kebijakan perubahan kata sandi diaktifkan atau dinonaktifkan untuk pengguna ini.
  • $PasswordProfile.ForceChangePasswordNextLogin - boolean yang menunjukkan bahwa pengguna harus mengubah kata sandi saat masuk berikutnya.
Type:PasswordProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

Menentukan nama kantor pengiriman fisik pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Menentukan kode pos pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Menentukan bahasa pilihan pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

Jika True, perlihatkan pengguna ini dalam daftar alamat.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SignInNames

Menentukan kumpulan nama masuk untuk akun lokal di penyewa Azure Active Directory B2C.

Setiap nama rincian masuk harus unik di seluruh perusahaan/penyewa. Properti harus ditentukan saat Anda membuat pengguna akun lokal. Jangan tentukan saat Anda membuat akun kerja atau sekolah.

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Menentukan status pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Menentukan alamat jalan pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Menentukan nama keluarga pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Menentukan nomor telepon.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Kode negara atau wilayah dua huruf (standar ISO 3166).

Diperlukan bagi pengguna yang akan diberi lisensi karena persyaratan hukum untuk memeriksa ketersediaan layanan di negara dan wilayah. Contohnya meliputi: US, JP, dan GB.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Menentukan nama prinsipal (UPN) pengguna.

UPN adalah nama untuk masuk berbasis Internet untuk pengguna berdasarkan standar Internet RFC 822. Menurut konvensi, ini harus dipetakan ke nama email pengguna. Format umumnya adalah alias@domain.

Untuk akun kantor atau sekolah, domain harus ada dalam kumpulan domain terverifikasi penyewa. Properti ini diperlukan saat akun kerja atau sekolah dibuat; ini opsional untuk akun lokal.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserState

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserType

Nilai string yang dapat digunakan untuk mengklasifikasikan jenis pengguna di direktori Anda, seperti "Anggota" dan "Tamu".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Catatan

Lihat panduan migrasi untuk New-AzureADUser ke Microsoft Graph PowerShell.