Set-AzureADUser
Memperbarui pengguna.
Sintaks
Set-AzureADUser
-ObjectId <String>
[-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 Set-AzureADUser memperbarui pengguna di Azure Active Directory (AD).
Contoh
Contoh 1: Memperbarui pengguna
PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com
PS C:\> $user.DisplayName = 'YetAnotherTestUser'
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname
Contoh 2: Atur semua pengguna tetapi ditentukan sebagai anak di bawah umur dengan persetujuan orang tua
Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }
Perintah ini memperbarui properti pengguna yang ditentukan.
Parameter
-AccountEnabled
Menunjukkan apakah akun diaktifkan.
Jenis: | Boolean |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-AgeGroup
Digunakan oleh aplikasi perusahaan untuk menentukan kelompok usia hukum pengguna. Properti ini baca-saja dan dihitung berdasarkan properti ageGroup dan consentProvidedForMinor . Nilai yang diizinkan: null
, minor
, notAdult
dan adult
. Lihat [definisi properti grup usia legal][Pelajari selengkapnya tentang kelompok usia dan definisi persetujuan kecil].
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-City
Menentukan kota pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CompanyName
Nama perusahaan yang dikaitkan dengan pengguna. Properti ini dapat berguna untuk menjelaskan perusahaan asal pengguna eksternal. Panjang maksimum nama perusahaan adalah 64 karakter.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ConsentProvidedForMinor
Mengatur apakah persetujuan telah diperoleh untuk anak di bawah umur. Nilai yang diizinkan: null
, granted
, denied
dan notRequired
. Lihat [definisi properti grup usia legal][Pelajari selengkapnya tentang kelompok usia dan definisi persetujuan kecil] untuk informasi lebih lanjut.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Country
Menentukan negara atau wilayah pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Department
Menentukan departemen pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisplayName
Menentukan nama tampilan pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ExtensionProperty
Tambahkan data ke properti pengguna kustom sebagai ekstensi terbuka dasar atau ekstensifikasi skema yang lebih serbaguna. Lihat [selengkapnya tentang ekstensi][Pelajari selengkapnya tentang ekstensi].
Jenis: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-FacsimileTelephoneNumber
Nomor faks pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-GivenName
Menentukan nama yang diberikan pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ImmutableId
Properti ini digunakan untuk mengaitkan akun pengguna Active Directory lokal ke objek pengguna Microsoft Azure ACTIVE Directory mereka. Properti ini harus ditentukan saat membuat akun pengguna baru di Grafik jika Anda menggunakan domain federasi untuk properti pengguna userPrincipalName
(UPN).
Penting: Karakter $ dan _ tidak dapat digunakan saat menentukan properti ini.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-IsCompromised
True jika pengguna ini disusupi
Jenis: | Boolean |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-JobTitle
Menentukan jabatan pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-MailNickName
Menentukan nama panggilan untuk alamat email pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Mobile
Menentukan nomor ponsel pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ObjectId
Menentukan ID pengguna (sebagai UPN atau ObjectId) di Azure AD.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-OtherMails
Menentukan alamat email lain untuk pengguna.
Jenis: | List<T>[String] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PasswordPolicies
Menentukan kebijakan kata sandi untuk pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PasswordProfile
Menentukan profil kata sandi pengguna.
Jenis: | PasswordProfile |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PhysicalDeliveryOfficeName
Lokasi kantor di tempat bisnis pengguna. Panjang maksimum adalah 128 karakter.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PostalCode
Menentukan kode pos pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PreferredLanguage
Menentukan bahasa pilihan pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ShowInAddressList
Atur ke True untuk memperlihatkan pengguna ini dalam daftar alamat.
Jenis: | Boolean |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SignInNames
Daftar nama masuk untuk pengguna ini
Jenis: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-State
Menentukan status pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-StreetAddress
Menentukan alamat jalan pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Surname
Menentukan nama keluarga pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TelephoneNumber
Menentukan nomor telepon pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UsageLocation
Kode negara atau wilayah dua huruf (standar ISO 3166). Diperlukan untuk pengguna yang akan diberi lisensi karena persyaratan hukum untuk memeriksa ketersediaan layanan di negara dan wilayah. Contohnya meliputi: "US", "JP", dan "GB". Tidak dapat diubah ke null.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UserPrincipalName
Menentukan nama utama pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UserState
Untuk pengguna eksternal yang diundang ke penyewa menggunakan API undangan, properti ini mewakili status undangan pengguna yang diundang. Untuk pengguna yang diundang, statusnya bisa PendingAcceptance
atau Accepted
, atau null
untuk semua pengguna lain.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UserStateChangedOn
Memperlihatkan tanda waktu untuk perubahan terbaru pada properti externalUserState.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UserType
Nilai string yang dapat digunakan untuk mengklasifikasikan jenis pengguna di direktori Anda, seperti "Anggota" dan "Tamu".
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Catatan
Lihat panduan migrasi untuk Set-AzureADUser ke Microsoft Graph PowerShell.