Get-Variable
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
Możesz potokować ciąg zawierający nazwę zmiennej do tego polecenia cmdlet.
Dane wyjściowe
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 Windows PowerShell zawiera następujące aliasy dla programu Get-Variable
:
gv
To polecenie cmdlet nie zarządza zmiennymi środowiskowymi. Aby zarządzać zmiennymi środowiskowymi, możesz użyć dostawcy zmiennych środowiskowych.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla