Suspend-Service

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menangguhkan (menjeda) satu atau beberapa layanan yang sedang berjalan.

Sintaks

Suspend-Service
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Deskripsi

Suspend-Service Cmdlet mengirimkan pesan penangguhan ke Pengontrol Layanan Windows untuk setiap layanan yang ditentukan. Saat ditangguhkan, layanan masih berjalan, tetapi tindakannya dihentikan sampai dilanjutkan, seperti dengan menggunakan Resume-Service cmdlet. Anda dapat menentukan layanan dengan nama layanan atau nama tampilannya, atau Anda dapat menggunakan parameter InputObject untuk meneruskan objek layanan yang mewakili layanan yang ingin Anda tangguhkan.

Contoh

Contoh 1: Menangguhkan layanan

PS C:\> Suspend-Service -DisplayName "Telnet"

Perintah ini menangguhkan layanan layanan Telnet (Tlntsvr) di komputer lokal.

Contoh 2: Menampilkan apa yang akan terjadi jika Anda menangguhkan layanan

PS C:\> Suspend-Service -Name lanman* -WhatIf

Perintah ini memberi tahu apa yang akan terjadi jika Anda menangguhkan layanan yang memiliki nama layanan yang dimulai dengan lanman. Untuk menangguhkan layanan, jalankan ulang perintah tanpa parameter WhatIf .

Contoh 3: Mendapatkan dan menangguhkan layanan

PS C:\> Get-Service schedule | Suspend-Service

Perintah ini menggunakan Get-Service cmdlet untuk mendapatkan objek yang mewakili layanan Task Scheduler (Schedule) pada komputer. Operator alur (|) meneruskan hasil ke Suspend-Service, yang menangguhkan layanan.

Contoh 4: Menangguhkan semua layanan yang dapat ditangguhkan

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

Perintah ini menangguhkan semua layanan pada komputer yang dapat ditangguhkan. Ini menggunakan Get-Service untuk mendapatkan objek yang mewakili layanan di komputer. Operator alur meneruskan hasil ke Where-Object cmdlet, yang hanya memilih layanan yang memiliki nilai $True untuk properti CanPauseAndContinue . Operator alur lain meneruskan hasil ke Suspend-Service. Parameter Konfirmasi meminta konfirmasi sebelum menangguhkan setiap layanan.

Parameter

-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

-DisplayName

Menentukan nama tampilan layanan yang akan ditangguhkan. Karakter kartubebas diizinkan.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Menentukan layanan yang akan dihilangkan dari layanan yang ditentukan. Nilai parameter ini memenuhi syarat parameter Nama . Masukkan elemen atau pola nama, seperti "s*". Karakter kartubebas diizinkan.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

Menentukan layanan yang akan ditangguhkan. Nilai parameter ini memenuhi syarat parameter Nama . Masukkan elemen atau pola nama, seperti "s*". Karakter kartubebas diizinkan.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

Menentukan objek ServiceController yang mewakili layanan untuk ditangguhkan. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama layanan layanan yang akan ditangguhkan. Karakter kartubebas diizinkan.

Nama parameter bersifat opsional. Anda dapat menggunakan Nama atau aliasnya, ServiceName, atau Anda dapat menghilangkan nama parameter.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

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

-WhatIf

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

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

Input

ServiceController

Anda dapat menyalurkan objek layanan ke cmdlet ini.

String

Anda dapat menyalurkan string yang berisi nama layanan ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

ServiceController

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek ServiceController yang mewakili layanan.

Catatan

  • Suspend-Service dapat mengontrol layanan hanya ketika pengguna saat ini memiliki izin untuk melakukan ini. Jika perintah tidak berfungsi dengan benar, Anda mungkin tidak memiliki izin yang diperlukan.
  • Suspend-Service hanya dapat menangguhkan layanan yang mendukung ditangguhkan dan dilanjutkan. Untuk menentukan apakah layanan tertentu dapat ditangguhkan, gunakan Get-Service cmdlet bersama dengan properti CanPauseAndContinue . Contohnya,Get-Service wmi | Format-List Name, CanPauseAndContinue. Untuk menemukan semua layanan di komputer yang dapat ditangguhkan, ketik Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
  • Untuk menemukan nama layanan dan nama tampilan layanan pada sistem Anda, ketik Get-Service. Nama layanan muncul di kolom Nama , dan nama tampilan muncul di kolom DisplayName .