Resolve-Path
Vyřeší zástupné znaky v cestě a zobrazí obsah cesty.
Syntaxe
Path (Výchozí)
Resolve-Path
[-Path] <string[]>
[-Relative]
[-RelativeBasePath <string>]
[-Credential <pscredential>]
[-Force]
[<CommonParameters>]
LiteralPath
Resolve-Path
-LiteralPath <string[]>
[-Relative]
[-RelativeBasePath <string>]
[-Credential <pscredential>]
[-Force]
[<CommonParameters>]
Description
Rutina Resolve-Path zobrazí položky a kontejnery, které odpovídají vzoru zástupných znaků v zadaném umístění. Shoda může zahrnovat soubory, složky, klíče registru nebo jakýkoli jiný objekt přístupný od poskytovatele PSDrivu .
Příklady
Příklad 1: Řešení cesty k domovské složce
Znak vlnovky (~) je zkratka pro domovskou složku aktuálního uživatele. Tento příklad ukazuje Resolve-Path vrácení plně kvalifikované hodnoty cesty.
Resolve-Path ~
Path
----
C:\Users\User01
Příklad 2: Řešení cesty ke složce Windows
Resolve-Path -Path "windows"
Path
----
C:\Windows
Při spuštění z kořenového C: adresáře jednotky tento příkaz vrátí cestu Windows ke složce na C: jednotce.
Příklad 3: Získání všech cest ve složce Windows
"C:\windows\*" | Resolve-Path
Tento příkaz vrátí všechny soubory a složky ve C:\Windows složce. Příkaz používá operátor kanálu (|) k odeslání řetězce cesty do Resolve-Path.
Příklad 4: Řešení cesty UNC
Resolve-Path -Path "\\Server01\public"
Tento příkaz vyřeší cestu UNC (Universal Naming Convention) a vrátí sdílené složky v cestě.
Příklad 5: Získání relativních cest
Resolve-Path -Path "C:\prog*" -Relative
.\Program Files
.\Program Files (x86)
.\programs.txt
Tento příkaz vrátí relativní cesty pro adresáře v kořenovém adresáři C: jednotky.
Příklad 6: Řešení cesty obsahující závorky
V tomto příkladu se k překladu . Použití LiteralPath způsobí, že hranaté závorky budou považovány za normální znaky místo regulárního výrazu.
Resolve-Path -LiteralPath 'test[xml]'
Příklad 7: Řešení cesty vzhledem k jiné složce
Tento příklad používá RelativeBasePath Pokud příkaz obsahuje parametr Relativní přepínač, vrátí řetězec představující relativní cestu ze $Env:TEMP spustitelného pwsh souboru.
$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $Env:TEMP -Relative
..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe
Příklad 8: Řešení cest pro skryté položky
Ve výchozím nastavení Resolve-Path nevrací skryté položky. V tomto příkladu se k překladu skrytých položek používá parametr Force . Příkaz Get-Item potvrdí, že je složka .git skrytá. Použití Resolve-Path bez parametru Force vrátí pouze viditelné položky. Přidání parametru Force vrátí všechny položky včetně skrytých položek.
PS> Get-Item .git -Force
Directory: D:\Git\PS-Docs\PowerShell-Docs
Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 9/25/2024 4:46 PM .git
PS> Resolve-Path .git*
Path
----
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Resolve-Path .git* -Force
Path
----
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
Parametry
-Credential
Určuje uživatelský účet, který má oprávnění k provedení této akce. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01nebo předejte objekt PSCredential . Pomocí rutiny můžete vytvořit objekt Get-Credential. Pokud zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Force
Umožňuje rutině získat položky, ke kterým jinak uživatel nemá přístup, například skryté nebo systémové soubory. Parametr Force nemá schopnost přepsat omezení zabezpečení. Implementace se liší mezi poskytovateli. Pro více informací viz about_Providers.
Tento parametr byl přidán v PowerShellu 7.5-preview.5.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu, která se má přeložit. Hodnota parametru LiteralPath se používá přesně podle typu. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje escape znaky, uzavřete ji do jednoduchých uvozovek ('). Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu PowerShellu, která se má přeložit. Tento parametr je povinný. Řetězec cesty můžete také převést na Resolve-Path. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Relative
Označuje, že tato rutina vrací relativní cestu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Path
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
LiteralPath
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RelativeBasePath
Určuje cestu, ze které se má přeložit relativní cesta. Při použití tohoto parametru vrátí rutina objekt System.Management.Automation.PathInfo pro přeloženou cestu.
Pokud použijete tento parametr s parametrem Relativní přepínač, vrátí rutina řetězec představující relativní cestu z RelativeBasePath do Path.
Tento parametr byl přidán v PowerShellu 7.4.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.
Výstupy
PathInfo
Ve výchozím nastavení vrátí tato rutina objekt PathInfo.
String
Pokud zadáte parametr Relativní , vrátí tato rutina hodnotu řetězce pro přeloženou cestu.
Poznámky
PowerShell obsahuje následující aliasy pro Resolve-Path:
- Všechny platformy:
rvpa
Rutiny *-Path pracují se zprostředkovateli FileSystem, Registry a Certificate .
Resolve-Path je navržený tak, aby fungoval s libovolným poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.
Resolve-Path Řeší pouze existující cesty. Nedá se použít k překladu umístění, které ještě neexistuje.
