Invoke-Item
Wykonuje akcję domyślną dla określonego elementu.
Składnia
Invoke-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Invoke-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Opis
Polecenie cmdlet Invoke-Item wykonuje domyślną akcję dla określonego elementu. Na przykład uruchamia plik wykonywalny lub otwiera plik dokumentu w aplikacji skojarzonej z typem pliku dokumentu.
Domyślna akcja zależy od typu elementu i jest określana przez dostawcę programu PowerShell, który zapewnia dostęp do danych.
Przykłady
Przykład 1. Otwieranie pliku
To polecenie otwiera plik aliasApr04.doc w programie Microsoft Office Word. W takim przypadku otwarcie w programie Word jest domyślną akcją dla plików .doc.
Invoke-Item "C:\Test\aliasApr04.doc"Przykład 2. Otwieranie wszystkich plików określonego typu
To polecenie otwiera wszystkie arkusze kalkulacyjne programu Microsoft Office Excel w folderze C:\Users\User1\Documents. Każdy arkusz kalkulacyjny jest otwierany w nowym wystąpieniu programu Excel. W takim przypadku otwieranie w programie Excel jest domyślną akcją dla plików .xls.
Invoke-Item "C:\Users\User1\Documents\*.xls"Parametry
-Confirm
Zachęca do potwierdzenia przed uruchomieniem cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Credential
Notatka
Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby podszywać się pod innego użytkownika lub podnieść swoje uprawnienia podczas uruchamiania tego polecenia cmdlet, użyj Invoke-Command.
| Typ: | PSCredential |
| Position: | Named |
| Domyślna wartość: | Current user |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Exclude
Określa jako tablicę ciągów element lub elementy, które to polecenie cmdlet wyklucza w operacji. Wartość tego parametru kwalifikuje parametr Path. Wprowadź element ścieżki lub wzorzec, taki jak *.txt. Dozwolone są wieloznaczne symbole. Parametr Exclude jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość katalogu C:\Windows.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | True |
-Filter
Określa filtr do określenia parametru ścieżki. Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell obsługującym korzystanie z filtrów. Składnię języka filtru FileSystem można znaleźć w about_Wildcards. Filtry są wydajniejsze niż inne parametry, ponieważ dostawca stosuje je, gdy polecenie cmdlet pobiera obiekty zamiast filtrować obiekty po ich pobraniu.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | True |
-Include
Określa jako tablicę ciągów element lub elementy, które to polecenie cmdlet zawiera w operacji. Wartość tego parametru kwalifikuje parametr Path. Wprowadź element ścieżki lub wzorzec, taki jak "*.txt". Dozwolone są wieloznaczne symbole. Parametr Include jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość katalogu C:\Windows.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | True |
-LiteralPath
Określa ścieżkę do co najmniej jednej lokalizacji. Wartość LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.
| Typ: | String[] |
| Aliasy: | PSPath, LP |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Path
Określa ścieżkę do wybranego elementu. Dozwolone są wieloznaczne symbole.
| Typ: | String[] |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | True |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest wykonywane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Możesz przekierować ciąg znaków zawierający ścieżkę do tego polecenia cmdlet.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca własnych danych wyjściowych, ale elementy, które wywołuje, mogą zwracać własne dane wyjściowe.
Uwagi
Program PowerShell zawiera następujące aliasy dla Invoke-Item:
ii
To polecenie cmdlet jest przeznaczone do pracy z danymi dostarczonymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.
