Rechtstreeks aanroepen van methoden van DSC-resourceCalling DSC resource methods directly

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

U kunt de Invoke-DscResource cmdlet rechtstreeks aanroepen van de functies of methoden van een DSC-resource (de Get-TargetResource, Set TargetResource, en Test-TargetResource functies van een bron op basis van MOF of de ophalen, ingesteld, en Test methoden van een bron op basis van een klasse).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). Dit kan worden gebruikt door derden die DSC-resources wilt gebruiken of als een nuttig hulpmiddel bij het ontwikkelen van resources.This can be used by third-parties that want to use DSC resources, or as a helpful tool while developing resources.

Deze cmdlet wordt doorgaans gebruikt in combinatie met een eigenschap metaconfiguratie refreshMode = 'Disabled', maar deze kan worden gebruikt, wat er ook refreshMode is ingesteld op.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.

Bij het aanroepen van de Invoke-DscResource cmdlet u opgeven welke methode of functie aan te roepen met behulp van de methode parameter.When calling the Invoke-DscResource cmdlet, you specify which method or function to call by using the Method parameter. U de eigenschappen van de resource opgeven door een hashtabel wordt doorgegeven als de waarde van de eigenschap parameter.You specify the properties of the resource by passing a hashtable as the value of the Property parameter.

Hier volgen enkele voorbeelden van methoden van de resource direct aan te roepen:The following are examples of directly calling resource methods:

Zorg ervoor dat een bestand aanwezig isEnsure 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

Testen of een bestand aanwezig isTest 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

De inhoud van bestand ophalenGet 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

Opmerking: rechtstreeks aanroepen van methoden van de samengestelde bron wordt niet ondersteund.Note: Directly calling composite resource methods is not supported. Roep in plaats daarvan de methoden van de onderliggende resources die gezamenlijk de samengestelde bron.Instead, call the methods of the underlying resources that make up the composite resource.

Zie ookSee Also