about_Language_Keywords

  • Artikel

Deskripsi singkat

Menjelaskan kata kunci dalam bahasa pembuatan skrip PowerShell.

Deskripsi panjang

PowerShell memiliki kata kunci bahasa berikut. Untuk informasi selengkapnya, lihat topik tentang kata kunci dan informasi yang mengikuti tabel.

Kata kunci Referensi
begin about_Functions, about_Functions_Advanced
break about_Break, about_Trap
catch about_Try_Catch_Finally
class about_Classes
continue about_Continue, about_Trap
data about_Data_Sections
define Disiapkan untuk penggunaan di masa mendatang
do about_Do, about_While
dynamicparam about_Functions_Advanced_Parameters
else about_If
elseif about_If
end about_Functions, about_Functions_Advanced_Methods
enum about_Enum
exit Dijelaskan dalam topik ini
filter about_Functions
finally about_Try_Catch_Finally
for about_For
foreach about_ForEach
from Disiapkan untuk penggunaan di masa mendatang
function about_Functions, about_Functions_Advanced
hidden about_Hidden
if about_If
in about_ForEach
param about_Functions
process about_Functions, about_Functions_Advanced
return about_Return
static about_Classes
switch about_Switch
throw about_Throw, about_Functions_Advanced_Methods
trap about_Trap, about_Break, about_Try_Catch_Finally
try about_Try_Catch_Finally
until about_Do
using about_Using, about_Classes
var Disiapkan untuk penggunaan di masa mendatang
while about_While, about_Do

Kata kunci berikut digunakan oleh alur kerja PowerShell:

  • inlinescript
  • parallel
  • sequence
  • workflow

Alur kerja PowerShell hanya didukung di PowerShell 5.1. Untuk informasi selengkapnya tentang alur kerja, lihat Menjalankan Perintah PowerShell dalam Alur Kerja.

begin

Menentukan satu bagian dari isi fungsi, bersama dengan dynamicparamkata kunci , , processdan end . Daftar begin pernyataan berjalan satu kali sebelum objek apa pun diterima dari alur.

Sintaks:

function <name> {
    dynamicparam {<statement list>}
    begin {<statement list>}
    process {<statement list>}
    end {<statement list>}
}

break

Menyebabkan skrip keluar dari perulangan.

Sintaks:

while (<condition>) {
   <statements>
   ...

   break
   ...

   <statements>
}

catch

Menentukan daftar pernyataan yang akan dijalankan jika terjadi kesalahan dalam daftar pernyataan yang menyertainya try . Jenis kesalahan memerlukan tanda kurung siku. Pasangan tanda kurung kedua menunjukkan bahwa jenis kesalahan bersifat opsional.

Sintaks:

try {<statement list>}
catch [[<error type>]] {<statement list>}

class

Menentukan kelas baru di PowerShell.

Sintaks:

class <class-name> {
    [[hidden] [static] <property-definition> ...]
    [<class-name>([argument-list>]) {<constructor-statement-list>} ...]
    [[hidden] [static] <method-definition> ...]
}

continue

Menyebabkan skrip berhenti menjalankan perulangan dan kembali ke kondisi tersebut. Jika kondisi terpenuhi, skrip memulai perulangan lagi.

Sintaks:

while (<condition>) {
   <statements>
   ...

   continue
   ...

   <statements>
}

data

Dalam skrip, menentukan bagian yang mengisolasi data dari logika skrip. Juga dapat menyertakan if pernyataan dan beberapa perintah terbatas.

Sintaks:

data <variable> [-supportedCommand <cmdlet-name>] {<permitted content>}

do

Digunakan dengan while kata kunci atau until sebagai konstruksi perulangan. PowerShell menjalankan daftar pernyataan setidaknya satu kali, tidak seperti perulangan yang menggunakan while.

Sintaks untuk while:

do {<statement list>} while (<condition>)

Sintaks untuk until:

do {<statement list>} until (<condition>)

dynamicparam

Menentukan satu bagian dari isi fungsi, bersama dengan beginkata kunci , , processdan end . Parameter dinamis ditambahkan pada runtime.

Sintaks:

function <name> {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

else

Digunakan dengan if kata kunci untuk menentukan daftar pernyataan default.

Sintaks:

if (<condition>) {<statement list>}
else {<statement list>}

elseif

Digunakan dengan if kata kunci dan else untuk menentukan kondisional tambahan. Kata else kunci bersifat opsional.

Sintaks:

if (<condition>) {<statement list>}
elseif (<condition>) {<statement list>}
else {<statement list>}

end

Menentukan satu bagian dari isi fungsi, bersama dengan dynamicparamkata kunci , , begindan end . Daftar end pernyataan berjalan satu kali setelah semua objek diterima dari alur.

Sintaks:

function <name> {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

enum

enum digunakan untuk mendeklarasikan enumerasi; jenis berbeda yang terdiri dari sekumpulan label bernama yang disebut daftar enumerator.

Sintaks:

enum <enum-name> {
    <label> [= <int-value>]
    ...
}

exit

Menyebabkan PowerShell keluar dari skrip atau instans PowerShell.

Sintaks:

exit
exit <exitcode>

Saat Anda menggunakan pwsh dengan parameter File , .ps1 file (skrip) itu sendiri harus menyertakan instruksi untuk menangani kesalahan atau pengecualian apa pun yang terjadi saat skrip sedang berjalan. Anda hanya boleh menggunakan exit pernyataan untuk menunjukkan status pasca-eksekusi skrip.

Pada Windows, angka apa pun antara [int]::MinValue dan [int]::MaxValue diperbolehkan.

Di Unix, hanya angka positif antara [byte]::MinValue dan [byte]::MaxValue yang diizinkan. Angka negatif dalam rentang -1 through -255 secara otomatis diterjemahkan ke dalam angka positif dengan menambahkan 256. Misalnya, -2 diubah menjadi 254.

Di PowerShell, exit pernyataan menetapkan nilai $LASTEXITCODE variabel. Di Windows Command Shell (cmd.exe), pernyataan keluar menetapkan nilai %ERRORLEVEL% variabel lingkungan.

Argumen apa pun yang non-numerik atau di luar rentang khusus platform diterjemahkan ke nilai 0.

Dalam contoh berikut, pengguna mengatur nilai variabel tingkat kesalahan ke 4 dengan menambahkan exit 4 ke file test.ps1skrip .

C:\scripts\test>type test.ps1
1
2
3
exit 4

C:\scripts\test>pwsh -file ./test.ps1
1
2
3

C:\scripts\test>echo %ERRORLEVEL%
4

Saat Anda menjalankan pwsh.exe -File <path to a script> dan file skrip berakhir dengan exit perintah, kode keluar diatur ke argumen numerik yang digunakan dengan exit perintah . Jika skrip tidak exit memiliki pernyataan, kode keluar selalu 0 ketika skrip selesai tanpa kesalahan atau 1 ketika skrip berakhir dari pengecualian yang tidak tertangani.

filter

Menentukan fungsi di mana daftar pernyataan berjalan satu kali untuk setiap objek input. Ini memiliki efek yang sama dengan fungsi yang hanya process berisi blok.

Sintaks:

filter <name> {<statement list>}

finally

Menentukan daftar pernyataan yang berjalan setelah pernyataan yang terkait dengan try dan catch. finally Daftar pernyataan berjalan bahkan jika Anda menekan CTRL+C untuk meninggalkan skrip atau jika Anda menggunakan exit kata kunci dalam skrip.

Sintaks:

try {<statement list>}
catch [<error type>] {<statement list>}
finally {<statement list>}

for

Menentukan perulangan dengan kondisi.

Sintaks:

for (<initialize>; <condition>; <iterate>) { <statement list> }

foreach

Menentukan perulangan menggunakan setiap anggota koleksi.

Sintaks:

foreach (<item> in <collection>) { <statement list> }

from

Disiapkan untuk penggunaan masa mendatang.

function

Membuat daftar pernyataan bernama dari kode yang dapat digunakan kembali. Anda dapat memberi nama cakupan yang dimiliki fungsi. Anda juga dapat menentukan satu atau beberapa parameter bernama dengan menggunakan param kata kunci. Dalam daftar pernyataan fungsi, Anda dapat menyertakan dynamicparamdaftar pernyataan , , beginprocess, dan end .

Sintaks:

function [<scope:>]<name> {
   param ([type]<$pname1> [, [type]<$pname2>])
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

Anda juga memiliki opsi untuk menentukan satu atau beberapa parameter di luar daftar pernyataan setelah nama fungsi.

Sintaks:

function [<scope:>]<name> [([type]<$pname1>, [[type]<$pname2>])] {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

if

Mendefinisikan kondisi.

Sintaks:

if (<condition>) {<statement list>}

hidden

Menyembunyikan anggota kelas dari hasil Get-Member default cmdlet, IntelliSense, dan hasil penyelesaian tab.

Sintaks:

hidden [data type] $member_name

in

Digunakan dalam foreach pernyataan untuk membuat perulangan yang menggunakan setiap anggota koleksi.

Sintaks:

foreach (<item> in <collection>){<statement list>}

param

Menentukan parameter dalam fungsi.

Sintaks:

function [<scope:>]<name> {
   param ([type]<$pname1>[, [[type]<$pname2>]])
   <statement list>
}

process

Menentukan bagian dari isi fungsi, bersama dengan dynamicparamkata kunci , , begindan end . process Saat daftar pernyataan menerima input dari alur, process daftar pernyataan berjalan satu kali untuk setiap elemen dari alur. Jika alur tidak menyediakan objek, process daftar pernyataan tidak berjalan. Jika perintah adalah perintah pertama dalam alur, process daftar pernyataan berjalan satu kali.

Sintaks:

function <name> {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

return

Menyebabkan PowerShell meninggalkan cakupan saat ini, seperti skrip atau fungsi, dan menulis ekspresi opsional ke output.

Sintaks:

return [<expression>]

static

Menentukan properti atau metode yang ditentukan umum untuk semua instans kelas di mana ia ditentukan.

Lihat class untuk contoh penggunaan.

switch

Untuk memeriksa beberapa kondisi, gunakan switch pernyataan. Pernyataan switch ini setara dengan serangkaian if pernyataan, tetapi lebih sederhana.

Pernyataan mencantumkan switch setiap kondisi dan tindakan opsional. Jika kondisi diperoleh, tindakan dilakukan.

Sintaks 1:

switch [-regex|-wildcard|-exact][-casesensitive] ( <value> )
{
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   ...

   default {<statement list>}
}

Sintaks 2:

switch [-regex|-wildcard|-exact][-casesensitive] -file <filename>
{
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   ...

   default {<statement list>}
}

throw

Melempar objek sebagai kesalahan.

Sintaks:

throw [<object>]

trap

Menentukan daftar pernyataan yang akan dijalankan jika terjadi kesalahan. Jenis kesalahan memerlukan tanda kurung siku. Pasangan tanda kurung kedua menunjukkan bahwa jenis kesalahan bersifat opsional.

Sintaks:

trap [[<error type>]] {<statement list>}

try

Menentukan daftar pernyataan yang akan diperiksa kesalahannya saat pernyataan berjalan. Jika terjadi kesalahan, PowerShell terus berjalan dalam pernyataan catch atau finally . Jenis kesalahan memerlukan tanda kurung siku. Pasangan tanda kurung kedua menunjukkan bahwa jenis kesalahan bersifat opsional.

Sintaks:

try {<statement list>}
catch [[<error type>]] {<statement list>}
finally {<statement list>}

until

Digunakan dalam do pernyataan sebagai konstruksi perulangan di mana daftar pernyataan dijalankan setidaknya satu kali.

Sintaks:

do {<statement list>} until (<condition>)

using

Memungkinkan Anda untuk menunjukkan namespace layanan mana yang digunakan dalam sesi. Nama jenis, kelas, dan anggota memerlukan lebih sedikit pengetikan untuk mereferensikannya. Anda juga dapat menyertakan kelas dari modul.

Sintaks namespace:

using namespace <.Net-namespace>

Sintaks modul:

using module <module-name>

Sintaks rakitan:

using assembly <.NET-assembly-path>

Untuk informasi selengkapnya, lihat about_Using.

while

Pernyataan tersebut while adalah konstruksi perulangan di mana kondisi diuji sebelum pernyataan dijalankan. Jika kondisi salah, maka pernyataan tidak dijalankan.

Sintaks pernyataan:

while (<condition>) {
   <statements>
 }

Saat digunakan dalam pernyataan do , while adalah bagian dari konstruksi perulangan di mana daftar pernyataan dijalankan setidaknya satu kali.

do Sintaks perulangan:

do {<statement list>} while (<condition>)

Lihat juga