Chamando métodos do recurso DSC diretamenteCalling DSC resource methods directly

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

Você pode usar o cmdlet Invoke-DscResource para chamar diretamente as funções ou os métodos de um recurso DSC (As funções Get-TargetResource, Set-TargetResource e Test-TargetResource de um recurso baseado em MOF ou os métodos Get, Set e Test de um recurso baseado em classe).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). Isso pode ser usado por terceiros que querem usar recursos DSC, ou como uma ferramenta útil ao desenvolver recursos.This can be used by third-parties that want to use DSC resources, or as a helpful tool while developing resources.

Geralmente, esse cmdlet é usado em combinação com uma propriedade de metaconfiguração refreshMode = 'Disabled', mas pode ser usado, independentemente do refreshMode para o qual está definido.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.

Ao chamar o cmdlet Invoke-DscResource, você especifica qual método ou função chamar usando o parâmetro Method.When calling the Invoke-DscResource cmdlet, you specify which method or function to call by using the Method parameter. Especifique as propriedades do recurso passando uma tabela de hash como o valor do parâmetro Property.You specify the properties of the resource by passing a hashtable as the value of the Property parameter.

A seguir, exemplos de chamada direta aos métodos do recurso:The following are examples of directly calling resource methods:

Certificar-se de que um arquivo está presenteEnsure 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

Testar se um arquivo está presenteTest 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

Obter o conteúdo do arquivoGet 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

Observação: não é permitido chamar diretamente métodos de recurso de composição.Note: Directly calling composite resource methods is not supported. Em vez disso, chame os métodos de recursos subjacentes que compõem o recurso de composição.Instead, call the methods of the underlying resources that make up the composite resource.

Consulte TambémSee Also