DSC-naplóerőforrás

A következőkre vonatkozik: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration naplóerőforrása (DSC) egy olyan mechanizmust biztosít, amely üzeneteket ír a Microsoft-Windows-Desired State Configuration/Analitikus eseménynaplóba.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját tartalmazza. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul elérhető a PowerShell-galéria.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

Syntax

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

Megjegyzés

Alapértelmezés szerint csak a DSC működési naplói vannak engedélyezve. Mielőtt az elemzési napló elérhetővé vagy láthatóvá válik, engedélyezni kell. További információ: Hol találhatók a DSC-eseménynaplók?.

Tulajdonságok

Tulajdonság	Leírás
Üzenet	A Microsoft-Windows-Desired State Configuration/Elemzési eseménynaplóba írni kívánt üzenetet jelzi.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és típusa ResourceType, akkor a tulajdonság használatának szintaxisa a DependsOn = "[ResourceType]ResourceName"következő: .
PsDscRunAsCredential	Beállítja a hitelesítő adatokat a teljes erőforrás futtatásához.

Megjegyzés

A PsDscRunAsCredential common tulajdonság hozzá lett adva a WMF 5.0-s verziójához, hogy bármely DSC-erőforrást más hitelesítő adatokkal összefüggésben futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

Az alábbi példa bemutatja, hogyan lehet üzenetet felvenni a Microsoft-Windows-Desired State Configuration/Analitikus eseménynaplóba.

Megjegyzés

Ha ezzel az erőforrással futtatja a Test-DscConfiguration parancsot, az mindig $false ad vissza.

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.'
        }
    }
}