Sumber Daya DSC GroupSet
Berlaku Untuk: Windows PowerShell 5.x
Sumber daya GroupSet di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk mengelola grup lokal pada simpul target. Sumber daya ini adalah sumber daya komposit yang memanggil sumber daya Grup untuk setiap grup yang ditentukan dalam GroupName
parameter .
Gunakan sumber daya ini saat Anda ingin menambahkan dan/atau menghapus daftar anggota yang sama ke lebih dari satu grup, menghapus lebih dari satu grup, atau menambahkan lebih dari satu grup dengan daftar anggota yang sama.
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
GroupSet [string] #ResourceName
{
GroupName = [string[]]
[ MembersToInclude = [string[]] ]
[ MembersToExclude = [string[]] ]
[ Credential = [PSCredential] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Properti
Properti | Deskripsi |
---|---|
GroupName | Nama grup yang ingin Anda pastikan statusnya tertentu. |
Anggota | Gunakan properti ini untuk mengganti keanggotaan grup saat ini dengan anggota yang ditentukan. Nilai properti ini adalah array string formulir Domain\UserName . Jika Anda mengatur properti ini dalam konfigurasi, jangan gunakan properti MembersToExclude atau MembersToInclude . Melakukannya akan menghasilkan kesalahan. |
MembersToInclude | Gunakan properti ini untuk menambahkan anggota ke keanggotaan grup yang sudah ada. Nilai properti ini adalah array string formulir Domain\UserName . Jika Anda mengatur properti ini dalam konfigurasi, jangan gunakan properti Anggota . Melakukannya akan menghasilkan kesalahan. |
MembersToExclude | Gunakan properti ini untuk menghapus anggota dari keanggotaan grup yang ada. Nilai properti ini adalah array string formulir Domain\UserName . Jika Anda mengatur properti ini dalam konfigurasi, jangan gunakan properti Anggota . Melakukannya akan menghasilkan kesalahan. |
Kredensial | Kredensial yang diperlukan untuk mengakses sumber daya jarak jauh. Akun ini harus memiliki izin Direktori Aktif yang sesuai untuk menambahkan semua akun non-lokal ke grup; jika tidak, kesalahan akan terjadi. |
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 grup ada. Atur properti ini ke Tidak Ada untuk memastikan bahwa grup tidak ada. Mengaturnya ke Sajikan memastikan bahwa grup 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 1: Memastikan Grup ada
Contoh berikut menunjukkan cara memastikan bahwa ada dua grup yang disebut "myGroup" dan "myOtherGroup".
configuration GroupSetTest
{
Import-DscResource -ModuleName PSDesiredStateConfiguration
Node localhost
{
GroupSet GroupSetTest
{
GroupName = @("myGroup", "myOtherGroup")
Ensure = "Present"
MembersToInclude = @("contoso\alice", "contoso\bob")
MembersToExclude = $("contoso\john")
Credential = Get-Credential
}
}
}
$cd = @{
AllNodes = @(
@{
NodeName = 'localhost'
PSDscAllowPlainTextPassword = $true
PSDscAllowDomainUser = $true
}
)
}
GroupSetTest -ConfigurationData $cd
Catatan
Contoh ini menggunakan kredensial teks biasa untuk kesederhanaan. Untuk informasi tentang cara mengenkripsi kredensial dalam file MOF konfigurasi, lihat Mengamankan File MOF.
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