Get-Variable

Referensi

Modul:: Microsoft.PowerShell.Utility

Mendapatkan variabel di konsol saat ini.

Sintaks

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Deskripsi

cmdlet Get-Variable mendapatkan variabel PowerShell di konsol saat ini. Anda hanya dapat mengambil nilai variabel dengan menentukan parameter ValueOnly, dan Anda dapat memfilter variabel yang dikembalikan berdasarkan nama.

Contoh

Contoh 1: Dapatkan variabel berdasarkan huruf

Perintah ini mendapatkan variabel dengan nama yang dimulai dengan huruf m. Perintah ini juga mendapatkan nilai variabel.

Get-Variable m*

Contoh 2: Dapatkan nilai variabel berdasarkan huruf

Perintah ini hanya mendapatkan nilai variabel yang memiliki nama yang dimulai dengan m.

Get-Variable m* -ValueOnly

Contoh 3: Dapatkan variabel dengan dua huruf

Perintah ini mendapatkan informasi tentang variabel yang dimulai dengan huruf M atau huruf P.

Get-Variable -Include M*,P*

Contoh 4: Dapatkan variabel berdasarkan cakupan

Perintah pertama hanya mendapatkan variabel yang ditentukan dalam cakupan lokal. Ini setara dengan Get-Variable -Scope Local dan dapat disingkat sebagai gv -s 0.

Perintah kedua menggunakan cmdlet Compare-Object untuk menemukan variabel yang ditentukan dalam cakupan induk (Cakupan 1) tetapi hanya terlihat dalam cakupan lokal (Cakupan 0).

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Parameter

-Exclude

Menentukan array item yang dikecualikan cmdlet ini dari operasi. Kartubebas diizinkan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-Include

Menentukan array item tempat cmdlet akan bertindak, tidak termasuk yang lain. Kartubebas diizinkan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-Name

Menentukan nama variabel. Kartubebas diizinkan. Anda juga dapat menyalurkan nama variabel ke Get-Variable.

Jenis:	String[]
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	True

-Scope

Menentukan variabel dalam cakupan. Nilai yang dapat diterima untuk parameter ini adalah:

Global
Lokal
Skrip
Angka relatif terhadap cakupan saat ini (0 melalui jumlah cakupan, di mana 0 adalah cakupan saat ini dan 1 adalah induknya)

Lokal adalah default. Untuk informasi selengkapnya, lihat about_Scopes.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ValueOnly

Menunjukkan bahwa cmdlet ini hanya mendapatkan nilai variabel.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

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

Output

PSVariable

Secara default, cmdlet ini mengembalikan objek AutomationPSVariable untuk setiap variabel yang didapatkannya. Jenis objek tergantung pada variabel.

Object[]

Saat Anda menentukan parameter ValueOnly dan nilai variabel yang ditentukan adalah koleksi, cmdlet ini mengembalikan [System.Object[]]. Perilaku ini mencegah operasi alur normal memproses nilai variabel satu per satu. Solusi untuk memaksa enumerasi pengumpulan adalah dengan mengapit perintah Get-Variable dalam tanda kurung.

Catatan

PowerShell menyertakan alias berikut untuk Get-Variable:

Semua platform:
- gv
Cmdlet ini tidak mengelola variabel lingkungan. Untuk mengelola variabel lingkungan, Anda dapat menggunakan penyedia Lingkungan.

Bagikan melalui