Bagikan melalui

about_CommonParameters

  • Artikel

Deskripsi singkat

Menjelaskan parameter yang dapat digunakan dengan cmdlet apa pun.

Deskripsi panjang

Parameter umum adalah sekumpulan parameter cmdlet yang dapat Anda gunakan dengan cmdlet apa pun. Mereka diimplementasikan oleh PowerShell, bukan oleh pengembang cmdlet, dan secara otomatis tersedia untuk cmdlet apa pun.

Anda dapat menggunakan parameter umum dengan cmdlet apa pun, tetapi mungkin tidak berpengaruh pada semua cmdlet. Misalnya, jika cmdlet tidak menghasilkan output verbose apa pun, menggunakan Verbose parameter umum tidak berpengaruh.

Parameter umum juga tersedia pada fungsi lanjutan yang menggunakan CmdletBinding atribut atau Parameter atribut . Saat Anda menggunakan atribut ini, PowerShell secara otomatis menambahkan Parameter Umum. Anda tidak dapat membuat parameter apa pun yang menggunakan nama yang sama dengan Parameter Umum.

Beberapa parameter umum mengambil alih default atau preferensi sistem yang Anda tetapkan menggunakan variabel preferensi PowerShell. Tidak seperti variabel preferensi, parameter umum hanya memengaruhi perintah tempat mereka digunakan.

Untuk informasi selengkapnya, lihat about_Preference_Variables.

Daftar berikut menampilkan parameter umum. Aliasnya tercantum dalam tanda kurung.

  • Debug (db)
  • ErrorAction (ea)
  • ErrorVariable (ev)
  • InformationAction (infa)
  • InformationVariable (iv)
  • OutVariable (ov)
  • OutBuffer (ob)
  • PipelineVariable (pv)
  • ProgressAction (proga)
  • Verbose (vb)
  • WarningAction (wa)
  • WarningVariable (wv)

Parameter Tindakan adalah nilai jenis ActionPreference . ActionPreference adalah enumerasi dengan nilai berikut:

Nama Nilai
Suspend 5
Ignore 4
Inquire 3
Continue 2
Stop 1
SilentlyContinue 0

Anda dapat menggunakan nama atau nilai dengan parameter .

Selain parameter umum, banyak cmdlet menawarkan parameter mitigasi risiko. Cmdlet yang melibatkan risiko terhadap sistem atau data pengguna biasanya menawarkan parameter ini.

Parameter mitigasi risiko adalah:

  • WhatIf (wi)
  • Confirm (cf)

Deskripsi parameter umum

-Debug

Menampilkan detail tingkat programmer tentang operasi yang dilakukan oleh perintah. Parameter ini hanya berfungsi ketika perintah menghasilkan pesan penelusuran kesalahan. Misalnya, parameter ini berfungsi saat perintah berisi Write-Debug cmdlet.

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

Secara default, pesan penelusuran kesalahan tidak ditampilkan karena nilai $DebugPreference variabelnya adalah SilentlyContinue.

Dalam mode interaktif, Debug parameter mengambil alih nilai $DebugPreference variabel untuk perintah saat ini, mengatur nilai $DebugPreference ke Inquire.

Dalam mode non-interaktif, Debug parameter mengambil alih nilai $DebugPreference variabel untuk perintah saat ini, mengatur nilai $DebugPreference ke Lanjutkan.

-Debug:$true memiliki efek yang sama dengan -Debug. Gunakan -Debug:$false untuk menekan tampilan pesan penelusuran kesalahan saat $DebugPreference bukan SilentlyContinue, yang merupakan default.

-ErrorAction

Menentukan bagaimana cmdlet merespons kesalahan yang tidak mengakhiri dari perintah. Parameter ini hanya berfungsi ketika perintah menghasilkan kesalahan yang tidak mengakhiri, seperti yang berasal dari Write-Error cmdlet.

Type: ActionPreference
Aliases: ea
Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Parameter ErrorAction mengambil alih nilai $ErrorActionPreference variabel untuk perintah saat ini. Karena nilai $ErrorActionPreference default variabel adalah Lanjutkan, pesan kesalahan ditampilkan dan eksekusi berlanjut kecuali Anda menggunakan parameter ErrorAction .

Parameter ErrorAction tidak berpengaruh pada penghentian kesalahan (seperti data yang hilang, parameter yang tidak valid, atau tidak cukup izin) yang mencegah perintah berhasil diselesaikan.

  • -ErrorAction:Break Masukkan debugger ketika terjadi kesalahan atau pengecualian dimunculkan.
  • -ErrorAction:Continue menampilkan pesan kesalahan dan melanjutkan menjalankan perintah. Continue adalah defaultnya.
  • -ErrorAction:Ignore menyembunyikan pesan kesalahan dan terus menjalankan perintah. Tidak seperti SilentlyContinue, Ignore tidak menambahkan pesan kesalahan ke $Error variabel otomatis. Nilai Abaikan diperkenalkan di PowerShell 3.0.
  • -ErrorAction:Inquire menampilkan pesan kesalahan dan meminta konfirmasi sebelum melanjutkan eksekusi. Nilai ini jarang digunakan.
  • -ErrorAction:SilentlyContinue menyembunyikan pesan kesalahan dan terus menjalankan perintah.
  • -ErrorAction:Stop menampilkan pesan kesalahan dan berhenti menjalankan perintah.
  • -ErrorAction:Suspend hanya tersedia untuk alur kerja yang tidak didukung di PowerShell 6 dan yang lebih baru.

Catatan

Parameter ErrorAction mengambil alih, tetapi tidak menggantikan nilai $ErrorActionPreference variabel saat parameter digunakan dalam perintah untuk menjalankan skrip atau fungsi.

-ErrorVariable

Rekaman kesalahan secara otomatis disimpan dalam $Error variabel otomatis. Untuk informasi selengkapnya, lihat about_Automatic_Variables.

Saat Anda menggunakan parameter ErrorVariable pada perintah, PowerShell juga menyimpan rekaman kesalahan yang dipancarkan oleh perintah dalam variabel yang ditentukan oleh parameter .

Type: String
Aliases: ev
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Secara default, pesan kesalahan baru menimpa pesan kesalahan yang sudah disimpan dalam variabel. Untuk menambahkan pesan kesalahan ke konten variabel, letakkan tanda plus (+) sebelum nama variabel.

Misalnya, perintah berikut membuat $a variabel lalu menyimpan kesalahan apa pun di dalamnya:

Get-Process -Id 6 -ErrorVariable a

Perintah berikut menambahkan pesan kesalahan apa pun ke $a variabel:

Get-Process -Id 2 -ErrorVariable +a

Perintah berikut menampilkan konten $a:

$a

Anda dapat menggunakan parameter ini untuk membuat variabel yang hanya berisi pesan kesalahan dari perintah tertentu dan tidak memengaruhi perilaku $Error variabel otomatis. Variabel $Error otomatis berisi pesan kesalahan dari semua perintah dalam sesi. Anda dapat menggunakan notasi array, seperti $a[0] atau $error[1,2] untuk merujuk ke kesalahan tertentu yang disimpan dalam variabel.

Catatan

Variabel kesalahan kustom berisi semua kesalahan yang dihasilkan oleh perintah, termasuk kesalahan dari panggilan ke fungsi atau skrip berlapis.

-InformationAction

Diperkenalkan di PowerShell 5.0. Dalam perintah atau skrip tempatnya digunakan, parameter umum InformationAction mengambil alih nilai $InformationPreference variabel preferensi, yang secara default diatur ke SilentlyContinue. Saat Anda menggunakan Write-Information dalam skrip dengan InformationAction, Write-Information nilai ditampilkan tergantung pada nilai parameter InformationAction . Untuk informasi selengkapnya tentang $InformationPreference, lihat about_Preference_Variables.

Type: ActionPreference
Aliases: infa
Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False
  • -InformationAction:Break Memasukkan debugger pada kemunculan Write-Information perintah.
  • -InformationAction:Stop menghentikan perintah atau skrip pada kemunculan Write-Information perintah.
  • -InformationAction:Ignore menekan pesan informasi dan terus menjalankan perintah. Tidak seperti SilentlyContinue, Abaikan sepenuhnya melupakan pesan informasi; itu tidak menambahkan pesan informasi ke aliran informasi.
  • -InformationAction:Inquire menampilkan pesan informasi yang Anda tentukan dalam Write-Information perintah, lalu menanyakan apakah Anda ingin melanjutkan.
  • -InformationAction:Continue menampilkan pesan informasi, dan terus berjalan.
  • -InformationAction:Suspend tidak didukung di PowerShell 6 dan yang lebih tinggi karena hanya tersedia untuk alur kerja.
  • -InformationAction:SilentlyContinue tidak ada efek karena pesan informasi tidak (Default) ditampilkan, dan skrip berlanjut tanpa gangguan.

Catatan

Parameter InformationAction mengambil alih, tetapi tidak menggantikan nilai $InformationAction variabel preferensi saat parameter digunakan dalam perintah untuk menjalankan skrip atau fungsi.

-InformationVariable

Diperkenalkan di PowerShell 5.0. Saat Anda menggunakan parameter umum InformationVariable , rekaman informasi disimpan dalam variabel yang ditentukan oleh parameter . Dan cmdlet PowerShell dapat menulis rekaman informasi ke aliran Informasi . Anda juga dapat menggunakan Write-Information cmdlet untuk menulis rekaman informasi.

Rekaman informasi ditampilkan sebagai pesan di konsol secara default. Anda dapat mengontrol tampilan rekaman informasi dengan menggunakan parameter umum InformationAction . Anda juga dapat mengubah perilaku menggunakan $InformationPreference variabel preferensi. Untuk informasi selengkapnya tentang $InformationPreference, lihat about_Preference_Variables.

Catatan

Variabel informasi berisi semua pesan informasi yang dihasilkan oleh perintah, termasuk pesan informasi dari panggilan ke fungsi atau skrip berlapis.

Type: String
Aliases: iv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Secara default, rekaman informasi baru menimpa nilai yang sudah disimpan dalam variabel. Untuk menambahkan pesan kesalahan ke konten variabel, letakkan tanda plus (+) sebelum nama variabel.

-OutBuffer

Menentukan jumlah objek yang akan terakumulasi dalam buffer sebelum objek dikirim melalui alur. Jika Anda menghilangkan parameter ini, objek dikirim saat dibuat.

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

Parameter manajemen sumber daya ini dirancang untuk pengguna tingkat lanjut. Saat Anda menggunakan parameter ini, PowerShell mengirim data ke cmdlet berikutnya dalam batch OutBuffer + 1.

Contoh berikut bergantian ditampilkan antara untuk ForEach-Object memproses blok yang menggunakan Write-Host cmdlet. Tampilan bergantian dalam batch 2 atau OutBuffer + 1.

1..4 | ForEach-Object {
        Write-Host "$($_): First"; $_
      } -OutBuffer 1 | ForEach-Object {
                        Write-Host "$($_): Second" }

1: First
2: First
1: Second
2: Second
3: First
4: First
3: Second
4: Second

-OutVariable

Menyimpan objek output dari perintah dalam variabel yang ditentukan selain mengirim output di sepanjang alur.

Type: String
Aliases: ov
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Untuk menambahkan output ke variabel, alih-alih mengganti output apa pun yang mungkin sudah disimpan di sana, ketik tanda plus (+) sebelum nama variabel.

Misalnya, perintah berikut membuat $out variabel dan menyimpan objek proses di dalamnya:

Get-Process PowerShell -OutVariable out

Perintah berikut menambahkan objek proses ke $out variabel:

Get-Process iexplore -OutVariable +out

Perintah berikut menampilkan konten $out variabel:

$out

Catatan

Variabel yang dibuat oleh parameter OutVariable adalah [System.Collections.ArrayList].

-PipelineVariable

PipelineVariable memungkinkan akses ke nilai terbaru yang diteruskan ke segmen alur berikutnya oleh perintah yang menggunakan parameter ini. Perintah apa pun dalam alur dapat mengakses nilai menggunakan pipelineVariable bernama. Nilai ditetapkan ke variabel ketika diteruskan ke segmen alur berikutnya. Ini membuat PipelineVariable lebih mudah digunakan daripada variabel sementara tertentu, yang mungkin perlu ditetapkan di beberapa lokasi.

Tidak seperti $_ atau , menggunakan PipelineVariable memungkinkan perintah alur apa pun untuk mengakses nilai alur yang diteruskan (dan disimpan) oleh perintah selain $PSItemperintah sebelumnya segera. Perintah alur dapat mengakses nilai terakhir yang disalurkan saat memproses item berikutnya yang melewati alur. Ini memungkinkan perintah untuk mengumpankan kembali outputnya ke perintah sebelumnya (atau itu sendiri).

Catatan

Fungsi tingkat lanjut dapat memiliki hingga tiga blok skrip: begin, , processdan end. Saat menggunakan parameter PipelineVariable dengan fungsi tingkat lanjut, hanya nilai dari blok skrip pertama yang ditentukan yang ditetapkan ke variabel saat fungsi berjalan. Untuk informasi selengkapnya, lihat Fungsi tingkat lanjut. PowerShell 7.2 mengoreksi perilaku ini.

Type: String
Aliases: pv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Nilai yang valid adalah string, sama seperti untuk nama variabel apa pun.

Perhatian

PipelineVariable dilingkup ke alur tempat alur dipanggil. Variabel di luar alur, yang menggunakan nama yang sama, dibersihkan sebelum alur dijalankan. PipelineVariable keluar dari cakupan ketika alur berakhir. Jika beberapa perintah dalam alur menentukan PipelineVariable yang sama, maka hanya ada satu variabel bersama. Variabel tersebut diperbarui dengan output piped terbaru dari perintah yang menentukan variabel.

Beberapa perintah pemblokiran mengumpulkan semua item alur sebelum menghasilkan output apa pun, misalnya Sort-Object atau Select-Object -Last. Setiap PipelineVariable yang ditetapkan dalam perintah sebelum perintah pemblokiran seperti itu selalu berisi item pipa akhir dari perintah sebelumnya saat digunakan dalam perintah setelah perintah pemblokiran.

Berikut ini adalah contoh cara kerja PipelineVariable . Dalam contoh ini, parameter PipelineVariable ditambahkan ke Foreach-Object perintah untuk menyimpan hasil perintah dalam variabel. Rentang angka, 1 hingga 5, disalurkan ke perintah pertama Foreach-Object , yang hasilnya disimpan dalam variabel bernama $temp.

Hasil perintah pertama Foreach-Object disalurkan ke perintah kedua Foreach-Object , yang menampilkan nilai saat ini dan $temp $_.

# Create a variable named $temp
$temp=8
Get-Variable temp
# Note that the variable just created isn't available on the
# pipeline when -PipelineVariable creates the same variable name
1..5 | ForEach-Object -PipelineVariable temp -Begin {
    Write-Host "Step1[BEGIN]:`$temp=$temp"
} -Process {
  Write-Host "Step1[PROCESS]:`$temp=$temp - `$_=$_"
  Write-Output $_
} | ForEach-Object {
  Write-Host "`tStep2[PROCESS]:`$temp=$temp - `$_=$_"
}
# The $temp variable is deleted when the pipeline finishes
Get-Variable temp

Name                           Value
----                           -----
temp                           8

Step1[BEGIN]:$temp=
Step1[PROCESS]:$temp= - $_=1
        Step2[PROCESS]:$temp=1 - $_=1
Step1[PROCESS]:$temp=1 - $_=2
        Step2[PROCESS]:$temp=2 - $_=2
Step1[PROCESS]:$temp=2 - $_=3
        Step2[PROCESS]:$temp=3 - $_=3
Step1[PROCESS]:$temp=3 - $_=4
        Step2[PROCESS]:$temp=4 - $_=4
Step1[PROCESS]:$temp=4 - $_=5
        Step2[PROCESS]:$temp=5 - $_=5

Get-Variable : Cannot find a variable with the name 'temp'.
At line:1 char:1
+ Get-Variable temp
+ ~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (temp:String) [Get-Variable], ItemNotFoundException
    + FullyQualifiedErrorId : VariableNotFound,Microsoft.PowerShell.Commands.GetVariableCommand

-ProgressAction

Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress . Write-Progress Cmdlet membuat bilah kemajuan yang memperlihatkan status perintah. Parameter ProgressAction ditambahkan di PowerShell 7.4.

Parameter ProgressAction mengambil salah ActionPreference satu nilai enumerasi: SilentlyContinue, , Stop, Continue, InquireIgnore, Suspend, , atau Break.

Nilai yang valid adalah sebagai berikut:

  • Break Memasukkan debugger pada kemunculan Write-Progress perintah.
  • Stop: Tidak menampilkan bilah kemajuan. Sebaliknya, ia menampilkan pesan kesalahan dan berhenti mengeksekusi.
  • Inquire: Tidak menampilkan bilah kemajuan. Meminta izin untuk melanjutkan. Jika Anda membalas dengan Y atau A, maka akan menampilkan bilah kemajuan.
  • Continue: (Default) Menampilkan bilah kemajuan dan dilanjutkan dengan eksekusi.
  • SilentlyContinue: Menjalankan perintah, tetapi tidak menampilkan bilah kemajuan.
Type: ActionPreference
Aliases: proga
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

-Verbose

Menampilkan informasi terperinci tentang operasi yang dilakukan oleh perintah. Informasi ini menyerupan informasi dalam jejak atau dalam log transaksi. Parameter ini hanya berfungsi ketika perintah menghasilkan pesan verbose. Misalnya, parameter ini berfungsi saat perintah berisi Write-Verbose cmdlet.

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

Parameter Verbose mengambil alih nilai $VerbosePreference variabel untuk perintah saat ini. Karena nilai $VerbosePreference default variabel adalah SilentlyContinue, pesan verbose tidak ditampilkan secara default.

  • -Verbose:$true memiliki efek yang sama dengan -Verbose
  • -Verbose:$false menekan tampilan pesan verbose. Gunakan parameter ini saat nilai $VerbosePreference bukan SilentlyContinue (default).

-WarningAction

Menentukan bagaimana cmdlet merespons peringatan dari perintah. Lanjutkan adalah nilai default. Parameter ini hanya berfungsi ketika perintah menghasilkan pesan peringatan. Misalnya, parameter ini berfungsi saat perintah berisi Write-Warning cmdlet.

Type: ActionPreference
Aliases: wa
Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Parameter WarningAction mengambil alih nilai $WarningPreference variabel untuk perintah saat ini. Karena nilai $WarningPreference default variabel adalah Lanjutkan, peringatan ditampilkan dan eksekusi berlanjut kecuali Anda menggunakan parameter WarningAction .

  • -WarningAction:Break memasukkan debugger saat peringatan terjadi.
  • -WarningAction:Continue menampilkan pesan peringatan dan melanjutkan menjalankan perintah. Continue adalah defaultnya.
  • -WarningAction:Inquire menampilkan pesan peringatan dan meminta konfirmasi sebelum melanjutkan eksekusi. Nilai ini jarang digunakan.
  • -WarningAction:SilentlyContinue menekan pesan peringatan dan terus menjalankan perintah.
  • -WarningAction:Stop menampilkan pesan peringatan dan berhenti menjalankan perintah.

Catatan

Parameter WarningAction mengambil alih, tetapi tidak menggantikan nilai $WarningAction variabel preferensi saat parameter digunakan dalam perintah untuk menjalankan skrip atau fungsi.

-WarningVariable

Menyimpan rekaman peringatan tentang perintah dalam variabel yang ditentukan.

Type: String
Aliases: wv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Semua peringatan yang dihasilkan disimpan dalam variabel bahkan jika peringatan tidak ditampilkan kepada pengguna.

Untuk menambahkan peringatan ke konten variabel, alih-alih mengganti peringatan apa pun yang mungkin sudah disimpan di sana, ketik tanda plus (+) sebelum nama variabel.

Misalnya, perintah berikut membuat $a variabel lalu menyimpan peringatan apa pun di dalamnya:

Get-Process -Id 6 -WarningVariable a

Perintah berikut menambahkan peringatan apa pun ke $a variabel:

Get-Process -Id 2 -WarningVariable +a

Perintah berikut menampilkan konten $a:

$a

Anda dapat menggunakan parameter ini untuk membuat variabel yang hanya berisi peringatan dari perintah tertentu. Anda dapat menggunakan notasi array, seperti $a[0] atau $warning[1,2] untuk merujuk ke peringatan tertentu yang disimpan dalam variabel.

Catatan

Variabel peringatan berisi semua peringatan yang dihasilkan oleh perintah, termasuk peringatan dari panggilan ke fungsi atau skrip berlapis.

Deskripsi Parameter Manajemen Risiko

-WhatIf

Menampilkan pesan yang menjelaskan efek perintah, alih-alih menjalankan perintah.

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

Parameter WhatIf mengambil alih nilai $WhatIfPreference variabel untuk perintah saat ini. Karena nilai $WhatIfPreference default variabel adalah 0 (dinonaktifkan), perilaku WhatIf tidak dilakukan tanpa parameter WhatIf . Untuk informasi selengkapnya, lihat about_Preference_Variables.

  • -WhatIf:$true memiliki efek yang sama dengan -WhatIf.
  • -WhatIf:$false menekan perilaku WhatIf otomatis yang menghasilkan ketika nilai $WhatIfPreference variabel adalah 1.

Misalnya, perintah berikut menggunakan -WhatIf parameter dalam Remove-Item perintah:

Remove-Item Date.csv -WhatIf

Alih-alih menghapus item, PowerShell mencantumkan operasi yang akan dilakukannya dan item yang akan terpengaruh. Perintah ini menghasilkan output berikut:

What if: Performing operation "Remove File" on
Target "C:\ps-test\date.csv".

-Confirm

Meminta konfirmasi sebelum menjalankan perintah.

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

Parameter Confirm mengambil alih nilai $ConfirmPreference variabel untuk perintah saat ini. Nilai defaultnya adalah true. Untuk informasi selengkapnya, lihat about_Preference_Variables.

  • -Confirm:$true memiliki efek yang sama dengan -Confirm.
  • -Confirm:$false menekan konfirmasi otomatis, yang terjadi ketika nilai kurang dari $ConfirmPreference atau sama dengan perkiraan risiko cmdlet.

Misalnya, perintah berikut menggunakan Confirm parameter dengan Remove-Item perintah . Sebelum menghapus item, PowerShell mencantumkan operasi yang akan dilakukannya dan item yang akan terpengaruh, dan meminta persetujuan.

PS C:\ps-test> Remove-Item tmp*.txt -Confirm

Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target " C:\ps-test\tmp1.txt
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend
[?] Help (default is "Y"):

Opsi Confirm responsnya adalah sebagai berikut:

Respons Hasil
YesAku akan menemuinya.Y Lakukan aksinya.
Yes to AllAku akan menemuinya.A Lakukan semua tindakan dan tekan berikutnya Confirm
kueri untuk perintah ini.
No (N): Jangan lakukan tindakan.
No to All (L): Jangan melakukan tindakan apa pun dan menekan tindakan berikutnya
Confirm kueri untuk perintah ini.
Suspend (S): Jeda perintah dan buat sesi sementara.
HelpAku akan menemuinya.? Tampilkan bantuan untuk opsi ini.

Opsi Tangguhkan menempatkan perintah ditangguhkan dan membuat sesi berlapis sementara tempat Anda dapat bekerja hingga Anda siap untuk memilih Confirm opsi. Perintah untuk sesi berlapis memiliki dua tanda sisipan tambahan (>>) untuk menunjukkan bahwa itu adalah operasi turunan dari perintah induk asli. Anda dapat menjalankan perintah dan skrip dalam sesi berlapis. Untuk mengakhiri sesi berlapis dan kembali ke Confirm opsi untuk perintah asli, ketik "exit".

Dalam contoh berikut, opsi Tangguhkan (S) digunakan untuk menghentikan perintah sementara saat pengguna memeriksa bantuan untuk parameter perintah. Setelah mendapatkan informasi yang diperlukan, jenis pengguna "keluar" untuk mengakhiri perintah berlapis lalu memilih respons Ya (y) ke Confirm kueri.

PS C:\ps-test> New-Item -ItemType File -Name Test.txt -Confirm

Confirm
Are you sure you want to perform this action?

Performing operation "Create File" on Target "Destination:
C:\ps-test\test.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default
is "Y"): s

PS C:\ps-test> Get-Help New-Item -Parameter ItemType

-ItemType <string>
Specifies the provider-specified type of the new item.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       true (ByPropertyName)
Accept wildcard characters?  false

PS C:\ps-test> exit

Confirm
Are you sure you want to perform this action?
Performing operation "Create File" on Target "Destination: C:\ps-test\test
.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (defau
lt is "Y"): y

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---         8/27/2010   2:41 PM          0 test.txt

Lihat juga