Resolve-Path

  • Reference
Modul:
Microsoft.PowerShell.Management

Vyřeší zástupné znaky v cestě a zobrazí obsah cesty.

Syntaxe

Resolve-Path
       [-Path] <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<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 cesty Test[xml] podsložky používá parametr LiteralPath. Použití literálPath způsobí, že hranaté závorky budou považovány za normální znaky, nikoli jako regulární výraz.

Resolve-Path -LiteralPath 'test[xml]'

Příklad 7: Řešení cesty vzhledem k jiné složce

Tento příklad používá RelativeBasePath parametr k překladu cesty spustitelného pwsh souboru vzhledem k $env:TEMP. 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

Parametry

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01nebo předejte objekt PSCredential . Objekt PSCredential můžete vytvořit pomocí rutinyGet-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.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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 řídicí znaky, uzavřete ji do jednoduchých uvozovek ('). Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Relative

Označuje, že tato rutina vrací relativní cestu.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Řetězec, který obsahuje cestu k této rutině, můžete převést.

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. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_providers.

Resolve-Path Řeší pouze existující cesty. Nedá se použít k překladu umístění, které ještě neexistuje.