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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Menentukan kota pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Menentukan negara atau wilayah pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | 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.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Menentukan departemen pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Menentukan nama tampilan pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Nomor faks pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Menentukan nama yang diberikan pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
True jika pengguna ini disusupi
Jenis: | Boolean |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Menentukan jabatan pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Menentukan nama panggilan untuk alamat email pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Menentukan nomor ponsel pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Menentukan ID pengguna (sebagai UPN atau ObjectId) di Azure AD.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OtherMails
Menentukan alamat email lain untuk pengguna.
Jenis: | List<T>[String] |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordPolicies
Menentukan kebijakan kata sandi untuk pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
Menentukan profil kata sandi pengguna.
Jenis: | PasswordProfile |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Lokasi kantor di tempat bisnis pengguna. Panjang maksimum adalah 128 karakter.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Menentukan kode pos pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Menentukan bahasa pilihan pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Atur ke True untuk memperlihatkan pengguna ini dalam daftar alamat.
Jenis: | Boolean |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignInNames
Daftar nama masuk untuk pengguna ini
Jenis: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Menentukan status pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Menentukan alamat jalan pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Menentukan nama keluarga pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Menentukan nomor telepon pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Menentukan nama utama pengguna.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserStateChangedOn
Memperlihatkan tanda waktu untuk perubahan terbaru pada properti externalUserState.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | 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".
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Catatan
Lihat panduan migrasi untuk Set-AzureADUser ke Microsoft Graph PowerShell.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk