Get-Variable
Mendapatkan variabel di konsol saat ini.
Sintaks
Default (Default)
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. Kartu liar 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 array item tempat cmdlet akan bertindak, tidak termasuk yang lain. Kartu liar 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 |
-Name
Menentukan nama variabel.
Kartu liar diizinkan.
Anda juga dapat menyalurkan nama variabel ke Get-Variable.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Scope
Menentukan variabel dalam cakupan. Nilai yang dapat diterima untuk parameter ini adalah:
- Global
- Lokal
- Script
- 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.
Properti parameter
| Jenis: | String |
| 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 |
-ValueOnly
Menunjukkan bahwa cmdlet ini hanya mendapatkan nilai variabel.
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 |
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
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.
