Bagikan melalui

Suspend-Service

Modul:
Microsoft.PowerShell.Management Module

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

Sintaks

InputObject (Default) 

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

Default 

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

DisplayName 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

cmdlet Suspend-Service mengirim pesan penangguhan ke Pengontrol Layanan Windows untuk setiap layanan yang ditentukan. Saat ditangguhkan, layanan masih berjalan, tetapi tindakannya dihentikan hingga dilanjutkan, seperti dengan menggunakan cmdlet Resume-Service. 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

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

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

Get-Service schedule | Suspend-Service

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

Contoh 4: Menangguhkan semua layanan yang dapat ditangguhkan

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 cmdlet Where-Object, 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 konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Set parameter

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

-DisplayName

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

DisplayName
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-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 pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

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

-Include

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

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

-InputObject

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

Properti parameter

Jenis:

ServiceController[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

InputObject
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

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

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False
Alias:Nama Layanan

Set parameter

Default
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PassThru

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

Properti parameter

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

Set parameter

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

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Set parameter

(All)
Position:Named
Wajib:False
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

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

Cmdlet ini hanya tersedia di platform Windows.

  • Suspend-Service hanya dapat mengontrol layanan 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 cmdlet Get-Service 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.