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 , a zmienne zwracane przez nazwę można filtrować.

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 o dwie litery

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 i Get-Variable -Scope Local 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:

  • 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

Ciąg zawierający nazwę zmiennej można przekazać potokowi do Get-Variable.

Dane wyjściowe

PSVariable

To polecenie cmdlet zwraca obiekt System.Management.AutomationPSVariable dla każdej zmiennej, którą pobiera. Typ obiektu zależy od zmiennej.

Object[]

Po określeniu parametru ValueOnly , jeśli wartość określonej zmiennej jest kolekcją, Get-Variable zwraca wartość [System.Object[]]. 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

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