Bagikan melalui

Invoke-DscResource

Modul:
PSDesiredStateConfiguration Module

Menjalankan metode sumber daya PowerShell Desired State Configuration (DSC) tertentu.

Sintaks

Default (Default) 

Invoke-DscResource
    [-Name] <String>
    [[-ModuleName] <ModuleSpecification>]
    [-Method] <String>
    [-Property] <Hashtable>
    [<CommonParameters>]

Deskripsi

cmdlet Invoke-DscResource menjalankan metode sumber daya PowerShell Desired State Configuration (DSC) tertentu.

Cmdlet ini memanggil sumber daya DSC secara langsung, tanpa membuat dokumen konfigurasi. Dengan menggunakan cmdlet ini, produk manajemen konfigurasi dapat mengelola windows atau Linux dengan sumber daya DSC.

Cmdlet ini tidak berfungsi dengan sumber daya komposit. Sumber daya komposit adalah konfigurasi berparameter. Menggunakan sumber daya komposit memerlukan LCM.

Contoh

Contoh 1: Memanggil metode Set sumber daya dengan menentukan properti wajibnya

Contoh ini memanggil metode Set sumber daya bernama WindowsProcess dan menyediakan Jalur wajib dan properti Argumen untuk memulai proses Windows yang ditentukan.

Invoke-DscResource -Name WindowsProcess -Method Set -ModuleName PSDesiredStateConfiguration -Property @{
    Path      = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
    Arguments = ''
}

Contoh 2: Memanggil metode Uji sumber daya untuk modul tertentu

Contoh ini memanggil metode Pengujian sumber daya bernama WindowsProcess, yang ada dalam modul bernama PSDesiredStateConfiguration.

$SplatParam = @{
    Name       = 'WindowsProcess'
    ModuleName = 'PSDesiredStateConfiguration'
    Method     = 'Test'
    Property   = @{
        Path      = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
        Arguments = ''
    }
}

Invoke-DscResource @SplatParam

Parameter

-Method

Menentukan metode sumber daya yang dipanggil cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah: Get, Set, dan Test.

Properti parameter

Jenis:String
Nilai default:None
Nilai yang diterima:Get, Set, Test
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:2
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ModuleName

Menentukan nama modul yang menyediakan Sumber Daya DSC yang ditentukan untuk dipanggil.

Properti parameter

Jenis:ModuleSpecification
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:1
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama sumber daya DSC yang akan dipanggil.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Property

Menentukan nama properti sumber daya dan nilainya dalam tabel hash sebagai kunci dan nilai.

Properti parameter

Jenis:Hashtable
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:3
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

ModuleSpecification

Output

Object

Catatan

  • Di sumber daya Windows PowerShell 5.1 berjalan di bawah konteks Sistem kecuali ditentukan dengan konteks pengguna menggunakan kunci PsDscRunAsCredential. Di PowerShell 7.0, Sumber Daya yang berjalan dalam konteks pengguna, dan PsDscRunAsCredential tidak lagi didukung. Menggunakan kunci ini menyebabkan cmdlet melempar pengecualian.

  • Pada PowerShell 7, Invoke-DscResource tidak lagi mendukung pemanggilan sumber daya WMI DSC. Ini termasuk File dan sumber daya Log di PSDesiredStateConfiguration .