Udostępnij za pośrednictwem

Get-Variable

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Pobiera zmienne w bieżącej konsoli.

Składnia

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

Opis

Polecenie Get-Variable cmdlet pobiera zmienne programu PowerShell w bieżącej konsoli. Możesz pobrać tylko wartości zmiennych, określając parametr ValueOnly i filtrować zmienne zwrócone według nazwy.

Przykłady

Przykład 1. Pobieranie zmiennych według litery

To polecenie pobiera zmienne z nazwami rozpoczynającymi się literą m. Polecenie pobiera również wartość zmiennych.

Get-Variable m*

Przykład 2. Pobieranie wartości zmiennych według litery

To polecenie pobiera tylko wartości zmiennych, które mają nazwy rozpoczynające się od m.

Get-Variable m* -ValueOnly

Przykład 3. Pobieranie zmiennych według dwóch liter

To polecenie pobiera informacje o zmiennych rozpoczynających się literą M lub literą P.

Get-Variable -Include M*,P*

Przykład 4. Pobieranie zmiennych według zakresu

Pierwsze polecenie pobiera tylko zmienne zdefiniowane w zakresie lokalnym. Jest ona równoważna Get-Variable -Scope Local i może być skrócona jako gv -s 0.

Drugie polecenie używa Compare-Object polecenia cmdlet do znajdowania zmiennych zdefiniowanych w zakresie nadrzędnym (zakres 1), ale są widoczne tylko w zakresie lokalnym (zakres 0).

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

Parametry

-Exclude

Określa tablicę elementów, które to polecenie cmdlet wyklucza z operacji. Dozwolone są symbole wieloznaczne.

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

-Include

Określa tablicę elementów, na których będzie działać polecenie cmdlet, z wyłączeniem wszystkich innych. Dozwolone są symbole wieloznaczne.

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

-Name

Określa nazwę zmiennej. Dozwolone są symbole wieloznaczne. Możesz również przekazać nazwę zmiennej do Get-Variable.

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

-Scope

Określa zmienne w zakresie. Dopuszczalne wartości tego parametru to:

  • Globalnie
  • Lokalne
  • Skrypt
  • Liczba względem bieżącego zakresu (od 0 do liczby zakresów, gdzie 0 jest bieżącym zakresem, a 1 jest jego elementem nadrzędnym)

Ustawienie lokalne jest wartością domyślną. Aby uzyskać więcej informacji, zobacz about_Scopes.

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

-ValueOnly

Wskazuje, że to polecenie cmdlet pobiera tylko wartość zmiennej.

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

Dane wejściowe

String

Możesz potokować ciąg zawierający nazwę zmiennej do tego polecenia cmdlet.

Dane wyjściowe

PSVariable

Domyślnie to polecenie cmdlet zwraca obiekt AutomationPSVariable dla każdej pobieranej zmiennej. Typ obiektu zależy od zmiennej.

Object[]

Po określeniu parametru ValueOnly i wartości określonej zmiennej jest kolekcją, to polecenie cmdlet zwraca wartość [System.Object[]]. To zachowanie uniemożliwia normalne działanie potoku podczas przetwarzania wartości zmiennej pojedynczo. Obejściem wymuszania wyliczenia kolekcji jest ujęcie Get-Variable polecenia w nawiasy.

Uwagi

Program PowerShell zawiera następujące aliasy dla Get-Variableprogramu :

  • Wszystkie platformy:

    • gv

  • To polecenie cmdlet nie zarządza zmiennymi środowiskowymi. Aby zarządzać zmiennymi środowiskowymi, możesz użyć dostawcy zmiennych środowiskowych.