Recurso Log de DSCDSC Log Resource

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

O recurso Log na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para escrever mensagens no log de eventos Microsoft-Windows-Desired State Configuration/Analytic.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[]] ]
}

OBSERVAÇÃO: por padrão, somente os logs Operacionais da DSC são habilitados.NOTE: By default only the Operational logs for DSC are enabled. Antes que o log Analítico esteja disponível ou visível, ele deve ser habilitado.Before the Analytic log will be available or visible, it must be enabled. Veja o artigo a seguir.See the following article.

Onde estão os logs de eventos de DSC?Where are DSC Event Logs?

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
MensagemMessage Indica a mensagem que você deseja escreve no log de eventos Microsoft-Windows-Desired State Configuration/Analytic.Indicates the message you want to write to the Microsoft-Windows-Desired State Configuration/Analytic event log.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de a mensagem do log ser escrita.Indicates that the configuration of another resource must run before this log message gets written. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será 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".

ExemploExample

O exemplo a seguir mostra como incluir uma mensagem no log de eventos Microsoft-Windows-Desired State Configuration/Analytic.The following example shows how to include a message in the Microsoft-Windows-Desired State Configuration/Analytic event log.

Observação: se você executar Test-DscConfiguration com esse recurso configurado, ele sempre gerará $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."
        }
    }
}