Freigeben über

Convert-Path

  • Referenz
Modul:
Microsoft.PowerShell.Management

Konvertiert einen Pfad aus einem PowerShell-Pfad in einen PowerShell-Anbieterpfad.

Syntax

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<CommonParameters>]

Beschreibung

Das Convert-Path Cmdlet konvertiert einen Pfad aus einem PowerShell-Pfad in einen PowerShell-Anbieterpfad.

Beispiele

Beispiel 1: Konvertieren des Arbeitsverzeichnisses in einen Standarddateisystempfad

In diesem Beispiel wird das aktuelle Arbeitsverzeichnis konvertiert, das durch einen Punkt (.) dargestellt wird, in einen Standardmäßigen FileSystem-Pfad.

PS C:\> Convert-Path .
C:\

Beispiel 2: Konvertieren eines Anbieterpfads in einen Standardregistrierungspfad

In diesem Beispiel wird der PowerShell-Anbieterpfad in einen Standardregistrierungspfad konvertiert.

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

Beispiel 3: Konvertieren eines Pfads in eine Zeichenfolge

In diesem Beispiel wird der Pfad in das Startverzeichnis des aktuellen Anbieters konvertiert, bei dem es sich um den FileSystem-Anbieter handelt, in eine Zeichenfolge.

PS C:\> Convert-Path ~
C:\Users\User01

Beispiel 4: Konvertieren von Pfaden für ausgeblendete Elemente

Convert-Path Standardmäßig werden ausgeblendete Elemente nicht zurückgegeben. In diesem Beispiel wird der Parameter Force verwendet, um ausgeblendete Elemente zu finden. Der Get-Item Befehl bestätigt, dass der .git Ordner ausgeblendet ist. Wird Convert-Path ohne den Parameter Force verwendet, werden nur die sichtbaren Elemente zurückgegeben. Durch Hinzufügen des Parameters Force werden alle Elemente zurückgegeben, einschließlich ausgeblendeter Elemente.

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> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Convert-Path .git* -Force
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

Parameter

-Force

Ermöglicht dem Cmdlet, Elemente abzurufen, auf die andernfalls nicht vom Benutzer zugegriffen werden kann, z. B. ausgeblendete oder Systemdateien. Der Parameter Force überschreibt keine Sicherheitseinschränkungen. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers.

Dieser Parameter wurde in PowerShell 7.5-preview.5 hinzugefügt.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LiteralPath

Gibt als Zeichenfolgenarray den zu konvertierenden Pfad an. Der Wert des LiteralPath-Parameters wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter about_Quoting_Rules.

Typ:String[]
Aliase:PSPath, LP
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt den zu konvertierenden PowerShell-Pfad an.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

Eingaben

String

Sie können einen Pfad, aber keinen Literalpfad, an dieses Cmdlet weiterleiten.

Ausgaben

String

Dieses Cmdlet gibt eine Zeichenfolge zurück, die den konvertierten Pfad enthält.

Hinweise

PowerShell enthält die folgenden Aliase für Convert-Path:

  • Alle Plattformen:
    • cvpa

Die Cmdlets, die das Path-Substantiv enthalten, bearbeiten Pfadnamen und geben die Namen in einem präzisen Format zurück, das alle PowerShell-Anbieter interpretieren können. Sie sind für die Verwendung in Programmen und Skripts vorgesehen, in denen Sie den gesamten oder einen Teil eines Pfads in einem bestimmten Format anzeigen möchten. Verwenden Sie sie wie "Dirname", "Normpath", "Realpath", "Join" oder andere Pfadmanipulationen.

Sie können die Pfad-Cmdlets mit mehreren Anbietern verwenden, einschließlich fileSystem, Registry und Zertifikatanbietern.

Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.

Convert-Path konvertiert nur vorhandene Pfade. Es kann nicht verwendet werden, um einen Speicherort zu konvertieren, der noch nicht vorhanden ist.