Bagikan melalui

Invoke-DscResource

  • Referensi
Modul:
PSDesiredStateConfiguration

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

Sintaks

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

Deskripsi

Invoke-DscResource Cmdlet 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.

Catatan

Sebelum PSDesiredStateConfiguration 2.0.6, menggunakan Invoke-DscResource di PowerShell 7 memerlukan pengaktifan fitur eksperimental PowerShell. Untuk menggunakan cmdlet dalam versi 2.0.0 hingga 2.0.5, Anda harus mengaktifkannya dengan perintah berikut.

Enable-ExperimentalFeature PSDesiredStateConfiguration.InvokeDscResource

Contoh

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

Contoh ini memanggil metode Set sumber daya bernama WindowsProcess dan menyediakan properti Jalur dan Argumen wajib 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 Uji 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: Dapatkan, Atur, dan Uji.

Type:String
Accepted values:Get, Set, Test
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

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

Type:ModuleSpecification
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama sumber daya DSC yang akan dipanggil.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Property

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

Type:Hashtable
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

String

ModuleSpecification

Output

Object

Catatan

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

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