Stop-DscConfiguration

  • Referensi
Modul:
PSDesiredStateConfiguration

Menghentikan pekerjaan konfigurasi yang sedang berjalan.

Sintaks

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet Stop-DscConfiguration menghentikan pekerjaan konfigurasi yang sedang berjalan. Tentukan komputer mana yang berlaku untuk cmdlet ini dengan menggunakan sesi Common Information Model (CIM). Jika tidak ada pekerjaan konfigurasi yang berjalan, cmdlet ini mengembalikan pesan peringatan.

Stop-DscConfigurationhanya tersedia sebagai bagian dari rollup pembaruan November 2014 untuk Windows RT 8.1, Windows 8.1, dan Windows Server 2012 R2 dari pustaka Dukungan Microsoft. Sebelum Anda menggunakan cmdlet ini, tinjau informasi di Apa yang Baru di Windows PowerShell 5.0

Contoh

Contoh 1: Menghentikan pekerjaan konfigurasi

Dalam contoh ini, sesi CIM dibuat menggunakan New-CimSession cmdlet . Objek CimSession digunakan untuk menghentikan pekerjaan konfigurasi yang sedang berjalan.

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession menggunakan parameter ComputerName untuk menentukan komputer Server01. Parameter Kredensial menentukan akun pengguna. Objek CimSession disimpan dalam $Session variabel . Saat perintah dijalankan, Anda akan dimintai kata sandi akun pengguna.

Stop-DscConfiguration menggunakan parameter CimSession dan objek yang disimpan untuk $Session menghentikan pekerjaan konfigurasi.

Parameter

-AsJob

Menunjukkan bahwa cmdlet ini menjalankan perintah sebagai pekerjaan latar belakang. Untuk informasi selengkapnya tentang pekerjaan latar belakang PowerShell, lihat about_Jobs dan about_Remote_Jobs.

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

Type:SwitchParameter
Position:Named
Default value:False
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 dari 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

Stop-DscConfiguration tidak mendukung parameter Konfirmasi . Jika parameter Konfirmasi digunakan, kesalahan akan ditampilkan.

Untuk cmdlet PowerShell yang mendukung Konfirmasi, menggunakan parameter meminta verifikasi sebelum perintah dijalankan.

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

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
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, PowerShell menghitung batas pembatasan optimal 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