Sumber Daya Lingkungan DSC
Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x
Sumber daya Lingkungan di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk mengelola variabel lingkungan sistem.
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
Environment [string] #ResourceName
{
Name = [string]
[ Path = [bool] ]
[ Value = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Properti
Properti | Deskripsi |
---|---|
Nama | Menunjukkan nama variabel lingkungan yang ingin Anda pastikan statusnya. |
Jalur | Menentukan variabel lingkungan yang sedang dikonfigurasi. Atur properti ini ke $true jika variabel adalah variabel Jalur ; jika tidak, atur ke $false . Default adalah $false . Jika variabel yang dikonfigurasi adalah variabel Jalur , nilai yang disediakan melalui properti Nilai akan ditambahkan ke nilai yang ada. |
Nilai | Nilai yang akan ditetapkan ke variabel lingkungan. |
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 variabel ada. Atur properti ini ke Ada untuk membuat variabel lingkungan jika tidak ada atau untuk memastikan bahwa nilainya cocok dengan apa yang disediakan melalui properti Nilai jika variabel sudah ada. Atur ke Tidak Ada untuk menghapus variabel jika 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
Contoh berikut memastikan bahwa TestEnvironmentVariable ada dan memiliki nilai TestValue. Jika tidak ada, itu membuatnya.
Environment EnvironmentExample
{
Ensure = "Present" # You can also set Ensure to "Absent"
Name = "TestEnvironmentVariable"
Value = "TestValue"
}
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