Logboek van de DSC-ResourceDSC Log Resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

De logboek in Windows PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme voor berichten schrijven naar het gebeurtenislogboek van de Microsoft-Windows-gewenst status Configuration/analysen.The Log resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to write messages to the Microsoft-Windows-Desired State Configuration/Analytic event log.

Syntax

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

Opmerking: Standaard alleen de operationele logboeken voor DSC zijn ingeschakeld.NOTE: By default only the Operational logs for DSC are enabled. Voordat het analytische logboek beschikbaar of zichtbaar is, moet zijn ingeschakeld.Before the Analytic log will be available or visible, it must be enabled. Zie het volgende artikel.See the following article.

Waar zijn de gebeurtenislogboeken DSC?Where are DSC Event Logs?

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
BerichtMessage Hiermee geeft u het bericht dat u wilt schrijven naar het gebeurtenislogboek Microsoft-Windows-Desired status Configuration/analysen.Indicates the message you want to write to the Microsoft-Windows-Desired State Configuration/Analytic event log.
dependsOnDependsOn Geeft aan dat de configuratie van een andere resource moet worden uitgevoerd voordat dit logboekbericht wordt geschreven.Indicates that the configuration of another resource must run before this log message gets written. Bijvoorbeeld, als de ID van de resourceconfiguratie scriptblok die u wilt uitvoeren eerst is ResourceName en het type ResourceType, de syntaxis voor het gebruik van deze eigenschap is DependsOn = "[ResourceType]ResourceName".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".

VoorbeeldExample

Het volgende voorbeeld laat zien hoe een bericht in het gebeurtenislogboek Microsoft-Windows-Desired status Configuration/analysen opnemen.The following example shows how to include a message in the Microsoft-Windows-Desired State Configuration/Analytic event log.

Opmerking: als u Test DscConfiguration aan deze resource is geconfigureerd, wordt altijd geretourneerd $false.Note: if you run Test-DscConfiguration with this resource configured, it will always return $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."
        }
    }
}