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 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 równoważny Get-Variable -Scope Local i może być skrócony jako gv -s 0.

Drugie polecenie używa Compare-Object polecenia cmdlet do znalezienia 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:

  • Globalne
  • Lokalnych
  • 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)

Wartość lokalna to wartość domyślna. 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 zmiennej, którą pobiera. Typ obiektu zależy od zmiennej.

Object[]

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

Uwagi

Program PowerShell zawiera następujące aliasy dla programu 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.