Remove-DscConfigurationDocument

  • Referensi
Modul:
PSDesiredStateConfiguration

Menghapus dokumen konfigurasi dari penyimpanan konfigurasi DSC.

Sintaks

Remove-DscConfigurationDocument
      -Stage <Stage>
      [-Force]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Remove-DscConfigurationDocument Cmdlet menghapus dokumen konfigurasi (.moffile) dari penyimpanan konfigurasi Windows PowerShell Desired State Configuration (DSC). Selama konfigurasi, Start-DscConfiguration cmdlet menyalin .mof file ke folder di komputer target. Cmdlet ini menghapus dokumen konfigurasi tersebut dan melakukan pembersihan tambahan.

Cmdlet ini hanya tersedia sebagai bagian dari rollup pembaruan November 2014 untuk Windows RT 8.1, Windows 8.1, dan Windows Server 2012 R2.

Contoh

Contoh 1: Menghapus dokumen konfigurasi saat ini

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Remove-DscConfigurationDocument -Stage Current -CimSession $Session

Perintah pertama membuat sesi CIM dengan menggunakan New-CimSession cmdlet , lalu menyimpan objek CimSession dalam variabel $Session. Perintah meminta kata sandi kepada Anda. Untuk informasi selengkapnya, ketik Get-Help New-CimSession.

Perintah kedua menghapus dokumen konfigurasi saat ini untuk komputer yang ditentukan dalam CimSession yang disimpan di $Session.

Parameter

-AsJob

Menunjukkan bahwa cmdlet ini menjalankan perintah sebagai pekerjaan latar belakang.

Jika Anda menentukan parameter AsJob , perintah mengembalikan objek yang mewakili pekerjaan, lalu menampilkan prompt perintah. Anda dapat terus bekerja dalam sesi hingga pekerjaan selesai. Pekerjaan dibuat pada komputer lokal dan hasil dari komputer jarak jauh secara otomatis dikembalikan ke komputer lokal. Untuk mengelola pekerjaan, gunakan cmdlet Pekerjaan. Untuk mendapatkan hasil pekerjaan, gunakan Receive-Job cmdlet .

Untuk menggunakan parameter ini, komputer lokal dan jarak jauh harus dikonfigurasi untuk jarak jauh, dan pada Windows Vista dan versi sistem operasi Windows yang lebih baru, Anda harus membuka Windows PowerShell dengan opsi Jalankan sebagai administrator. Untuk informasi selengkapnya, lihat about_Remote_Requirements.

Untuk informasi selengkapnya tentang pekerjaan latar belakang Windows PowerShell, lihat about_Jobs dan about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Menjalankan cmdlet dalam sesi jarak jauh atau di komputer jarak jauh. Masukkan nama komputer atau objek sesi, seperti output cmdlet New-CimSession atau Get-CimSession .

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Menunjukkan bahwa cmdlet ini menghentikan pekerjaan konfigurasi yang sedang berjalan sebelum menghapus dokumen konfigurasi. Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Stage

Menentukan dokumen konfigurasi mana yang akan dihapus. Anda dapat menentukan beberapa dokumen. Nilai yang dapat diterima untuk parameter ini adalah:

  • Current - Hapus dokumen konfigurasi yang menjelaskan status sistem saat ini.
  • Pending - Hapus dokumen konfigurasi yang menjelaskan status sistem yang tertunda.
  • Previous - Hapus dokumen konfigurasi yang menjelaskan status sistem sebelumnya.
Type:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Accepted values:Current, Pending, Previous
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Menentukan jumlah maksimum operasi bersamaan yang dapat ditetapkan untuk menjalankan cmdlet. Jika parameter ini dihilangkan atau nilai 0 dimasukkan, maka Windows PowerShell menghitung batas pembatasan optimal untuk cmdlet berdasarkan jumlah cmdlet CIM yang berjalan di komputer. Batas pembatasan hanya berlaku untuk cmdlet saat ini, bukan ke sesi atau ke komputer.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

None