DSC-erőforrások metódusainak közvetlen hívásaCalling DSC resource methods directly

A következőkre vonatkozik: Windows PowerShell 5,0Applies To: Windows PowerShell 5.0

A Call -DscResource parancsmag használatával közvetlenül meghívhatja a DSC-erőforrás (egy MOF-alapú erőforrás funkcióit vagy metódusait Get-TargetResource Set-TargetResource Test-TargetResource , vagy egy osztály alapú erőforrás Get, setés test metódusait).You can use the Invoke-DscResource cmdlet to directly call the functions or methods of a DSC resource (The Get-TargetResource, Set-TargetResource, and Test-TargetResource functions of a MOF-based resource, or the Get, Set, and Test methods of a class-based resource). Ezt olyan külső felek is használhatják, akik DSC-erőforrásokat szeretnének használni, vagy az erőforrások fejlesztése során hasznos eszközként.This can be used by third-parties that want to use DSC resources, or as a helpful tool while developing resources.

Megjegyzés

A PowerShell 7.0 + verzióban a Invoke-DscResource már nem támogatja a WMI DSC-erőforrások meghívását.In PowerShell 7.0+, Invoke-DscResource no longer supports invoking WMI DSC resources. Ebbe beletartozik File a fájl -és PSDesiredStateConfiguration.This includes the File and Log resources in PSDesiredStateConfiguration.

Ez a parancsmag jellemzően a metaconfiguration tulajdonsággal együtt használatos refreshMode = 'Disabled' , de nem számítható fel, hogy milyen refreshMode van beállítva.This cmdlet is typically used in combination with a metaconfiguration property refreshMode = 'Disabled', but it can be used no matter what refreshMode is set to.

A parancsmag meghívásakor Invoke-DscResource meg kell adnia, hogy melyik metódust vagy függvényt kell meghívni a Method paraméter használatával.When calling the Invoke-DscResource cmdlet, you specify which method or function to call by using the Method parameter. Az erőforrás tulajdonságait úgy adhatja meg, hogy átadja a szórótábla a tulajdonság paraméter értékeként.You specify the properties of the resource by passing a hashtable as the value of the Property parameter.

Az alábbi példák az erőforrás-metódusok közvetlen hívására szolgálnak:The following are examples of directly calling resource methods:

Győződjön meg arról, hogy a fájl megtalálhatóEnsure a file is present

$result = Invoke-DscResource -Name File -Method Set -Property @{
              DestinationPath = "$env:SystemDrive\\DirectAccess.txt";
              Contents = 'This file is create by Invoke-DscResource'} -Verbose
$result | fl

Egy fájl jelenlétének teszteléseTest that a file is present

$result = Invoke-DscResource -Name File -Method Test -Property @{
              DestinationPath="$env:SystemDrive\\DirectAccess.txt";
              Contents='This file is create by Invoke-DscResource'} -Verbose
$result | fl

Fájl tartalmának beolvasásaGet the contents of file

$result = Invoke-DscResource -Name File -Method Get -Property @{
              DestinationPath="$env:SystemDrive\\DirectAccess.txt";
              Contents='This file is create by Invoke-DscResource'} -Verbose
$result.ItemValue | fl

Megjegyzés

Az összetett erőforrás-metódusok közvetlen hívása nem támogatott.Directly calling composite resource methods is not supported. Ehelyett hívja meg az összetett erőforrást alkotó alapul szolgáló erőforrások metódusait.Instead, call the methods of the underlying resources that make up the composite resource.

Lásd még:See Also