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 cmdlet Get-Variable pobiera zmienne programu PowerShell w bieżącej konsoli. Możesz pobrać tylko wartości zmiennych, określając parametr ValueOnly i można filtrować zmienne zwracane 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 on odpowiednikiem Get-Variable -Scope Local i może być skrócony jako gv -s 0.

Drugie polecenie używa polecenia cmdlet Compare-Object, aby znaleźć zmienne zdefiniowane 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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Name

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

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Scope

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

  • globalnej
  • lokalne
  • skryptu
  • 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)

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ValueOnly

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 a wartość określonej zmiennej jest kolekcją, to polecenie cmdlet zwraca [System.Object[]]. To zachowanie uniemożliwia normalne działanie potoku przetwarzania wartości zmiennej pojedynczo. Obejściem wymuszania wyliczenia kolekcji jest ujęcie polecenia Get-Variable w nawiasy.

Uwagi

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

  • Wszystkie platformy:

    • gv

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