Invoke-DscResource
Hiermee wordt een methode van een opgegeven DSC-resource uitgevoerd.
Syntaxis
Default (Standaard)
Invoke-DscResource
[-Name] <String>
[-Method] <String>
-ModuleName <ModuleSpecification>
-Property <Hashtable>
[<CommonParameters>]
Description
De Invoke-DscResource-cmdlet voert een methode uit van een opgegeven DSC-resource (Windows PowerShell Desired State Configuration). Voordat u deze cmdlet uitvoert, stelt u de vernieuwingsmodus van local Configuration Manager (LCM) in op Uitgeschakeld.
Met deze cmdlet wordt een DSC-resource rechtstreeks aangeroepen zonder een configuratiedocument te maken. Met deze cmdlet kunnen configuratiebeheerproducten windows beheren met behulp van DSC-resources. Deze cmdlet maakt ook foutopsporing van resources mogelijk wanneer de DSC-engine of LCM wordt uitgevoerd met foutopsporing ingeschakeld.
Deze cmdlet werkt niet met samengestelde resources. Samengestelde resources zijn geparameteriseerde configuraties. Voor het gebruik van samengestelde resources is de LCM vereist.
Voorbeelden
Voorbeeld 1: De setmethode van een resource aanroepen door de verplichte eigenschappen ervan op te geven
Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration
Met deze opdracht wordt de methode Set van een resource met de naam Log aangeroepen en wordt een message eigenschap opgegeven.
Voorbeeld 2: De testmethode van een resource voor een opgegeven module aanroepen
Invoke-DscResource -Name WindowsProcess -Method Test -Property @{Path = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'; Arguments = ''} -ModuleName PSDesiredStateConfiguration
Met deze opdracht wordt de methode Test van een resource met de naam WindowsProcess aangeroepen. Deze bevindt zich in de module PSDesiredStateConfiguration.
Parameters
-Method
Hiermee geeft u de methode op van de resource die door deze cmdlet wordt aangeroepen. De acceptabele waarden voor deze parameter zijn:
GetSetTest
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Geaccepteerde waarden: | Get, Set, Test |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-ModuleName
Hiermee geeft u de naam op van de module waaruit deze cmdlet de opgegeven resource aanroept.
Parametereigenschappen
| Type: | ModuleSpecification |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u de naam van de DSC-resource die moet worden gestart.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Property
Hiermee geeft u de naam van de resource-eigenschap en de bijbehorende waarde in een hash-tabel op als sleutel en waarde, respectievelijk.
Gebruik de cmdlet Get-DscResource om resource-eigenschappen en de bijbehorende typen te detecteren.
Parametereigenschappen
| Type: | Hashtable |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
