Sumber Daya Log DSC

Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x

Sumber daya Log di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk menulis pesan ke log peristiwa Microsoft-Windows-Desired State Configuration/Analytic.

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

Log [string] #ResourceName
{
    Message = [string]
    [ DependsOn = [string[]] ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Catatan

Secara default hanya log Operasional untuk DSC yang diaktifkan. Sebelum log Analitik tersedia atau terlihat, log tersebut harus diaktifkan. Untuk informasi selengkapnya, lihat Di mana Log Peristiwa DSC?.

Properti

Properti Deskripsi
Pesan Menunjukkan pesan yang ingin Anda tulis ke log peristiwa Microsoft-Windows-Desired State Configuration/Analytic.

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".
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 menunjukkan cara menyertakan pesan dalam log peristiwa Microsoft-Windows-Desired State Configuration/Analytic.

Catatan

Jika Anda menjalankan Test-DscConfiguration dengan sumber daya ini dikonfigurasi, itu akan selalu mengembalikan $false.

Configuration logResourceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {
        Log LogExample
        {
            Message = 'This message will appear in the Microsoft-Windows-Desired State Configuration/Analytic event log.'
        }
    }
}