Risorsa Log DSC
Si applica a: Windows PowerShell 4.0, Windows PowerShell 5.x
La risorsa Log in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per scrivere messaggi nel registro eventi Microsoft-Windows-Desired State Configuration/Analytic.
Nota
Questa documentazione di questa risorsa DSC illustra la versione inclusa in PowerShell prima della versione 7.2. Il modulo PSDscResources contiene risorse DSC nuove e aggiornate supportate ufficialmente da Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.
Per altre informazioni e la documentazione aggiornata, vedere la documentazione di riferimento di PSDscResources.
Sintassi
Log [string] #ResourceName
{
Message = [string]
[ DependsOn = [string[]] ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Nota
Per impostazione predefinita sono abilitati solo i log operativi per DSC. Per rendere disponibile o visibile il log analitico, è necessario abilitarlo. Per altre informazioni, vedere Dove sono i registri eventi DSC?.
Proprietà
Proprietà | Descrizione |
---|---|
Message | Indica il messaggio che si vuole scrivere nel registro eventi Microsoft-Windows-Desired State Configuration/Analytic. |
Proprietà comuni
Proprietà | Descrizione |
---|---|
DependsOn | Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa. Ad esempio, se il valore di ID del blocco script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il tipo è ResourceType, la sintassi per usare questa proprietà è DependsOn = "[ResourceType]ResourceName" . |
PsDscRunAsCredential | Imposta le credenziali per l'esecuzione dell'intera risorsa. |
Nota
La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali. Per altre informazioni, vedere Usare credenziali con risorse DSC.
Esempio
L'esempio seguente mostra come includere un messaggio nel registro eventi Microsoft-Windows-Desired State Configuration/Analytic.
Nota
Se si esegue Test-DscConfiguration con questa risorsa configurata, il cmdlet restituisce sempre $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.'
}
}
}
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per