Sumber Daya Pengguna DSC
Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x
Sumber daya Pengguna di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk mengelola akun pengguna lokal pada simpul target.
Catatan
Dokumentasi sumber daya DSC ini mencakup versi yang disertakan dengan PowerShell sebelum versi 7.2. Modul PSDscResources berisi Sumber Daya DSC baru dan yang diperbarui yang secara resmi didukung oleh Microsoft. Modul PSDscResources tersedia dari Galeri PowerShell.
Untuk informasi selengkapnya dan dokumentasi yang diperbarui, lihat dokumentasi referensi PSDscResources.
Sintaks
User [string] #ResourceName
{
UserName = [string]
[ Description = [string] ]
[ Disabled = [bool] ]
[ FullName = [string] ]
[ Password = [PSCredential] ]
[ PasswordChangeNotAllowed = [bool] ]
[ PasswordChangeRequired = [bool] ]
[ PasswordNeverExpires = [bool] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Properti
Properti | Deskripsi |
---|---|
UserName | Menunjukkan nama akun yang ingin Anda pastikan statusnya. |
Deskripsi | Menunjukkan deskripsi yang ingin Anda gunakan untuk akun pengguna. |
Nonaktif | Menunjukkan apakah akun diaktifkan. Atur properti ini ke $true untuk memastikan bahwa akun ini dinonaktifkan, dan atur ke $false untuk memastikan bahwa properti ini diaktifkan. |
FullName | Mewakili string dengan nama lengkap yang ingin Anda gunakan untuk akun pengguna. |
Kata sandi | Menunjukkan kata sandi yang ingin Anda gunakan untuk akun ini. |
PasswordChangeNotAllowed | Menunjukkan apakah pengguna dapat mengubah kata sandi. Atur properti ini ke $true untuk memastikan bahwa pengguna tidak dapat mengubah kata sandi, dan mengaturnya ke $false untuk memungkinkan pengguna mengubah kata sandi. Nilai defaultnya adalah $false . |
PasswordChangeRequired | Menunjukkan apakah pengguna harus mengubah kata sandi saat masuk berikutnya. Atur properti ini ke $true jika pengguna harus mengubah kata sandi. Nilai defaultnya adalah $true . |
PasswordNeverExpires | Menunjukkan apakah kata sandi akan kedaluwarsa. Untuk memastikan bahwa kata sandi untuk akun ini tidak akan pernah kedaluwarsa, atur properti ini ke $true . Atur ke $false jika kata sandi akan kedaluwarsa. Nilai defaultnya adalah $false . |
Properti umum
Properti | Deskripsi |
---|---|
DependsOn | Menunjukkan bahwa konfigurasi sumber daya lain harus berjalan sebelum sumber daya ini dikonfigurasi. Misalnya, jika ID blok skrip konfigurasi sumber daya yang ingin Anda jalankan terlebih dahulu adalah ResourceName dan jenisnya adalah ResourceType, sintaks untuk menggunakan properti ini adalah DependsOn = "[ResourceType]ResourceName" . |
Pastikan | Menunjukkan apakah akun ada. Atur properti ini ke Ada untuk memastikan bahwa akun ada, dan atur ke Tidak Ada untuk memastikan bahwa akun tidak ada. Nilai defaultnya adalah Ada. |
PsDscRunAsCredential | Mengatur kredensial untuk menjalankan seluruh sumber daya sebagai. |
Catatan
Properti umum PsDscRunAsCredential ditambahkan dalam WMF 5.0 untuk memungkinkan menjalankan sumber daya DSC apa pun dalam konteks info masuk lainnya. Untuk informasi selengkapnya, lihat Menggunakan Kredensial dengan Sumber Daya DSC.
Contoh
User UserExample
{
Ensure = "Present" # To ensure the user account does not exist, set Ensure to "Absent"
UserName = "SomeName"
Password = $passwordCred # This needs to be a credential object
DependsOn = "[Group]GroupExample" # Configures GroupExample first
}
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