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

Get-Variable Cmdlet 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 Compare-Object cmdlet 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.

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

-Include

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

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

-Name

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-ValueOnly

Menunjukkan bahwa cmdlet ini hanya mendapatkan nilai variabel.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Get-Variable perintah 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 variabel lingkungan.