Freigeben über

Join-Path

  • Referenz
Modul:
Microsoft.PowerShell.Management

Kombiniert einen Pfad und einen untergeordneten Pfad zu einem Pfad.

Syntax

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

Beschreibung

Das Join-Path Cmdlet kombiniert einen Pfad und einen untergeordneten Pfad zu einem einzelnen Pfad. Der Anbieter stellt die Pfadtrennzeichen bereit.

Beispiele

Beispiel 1: Kombinieren eines Pfads mit einem untergeordneten Pfad

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Dieser Befehl verwendet Join-Path , um einen Pfad mit einem untergeordneten Pfad zu kombinieren.

Da der Befehl vom FileSystem Anbieter ausgeführt wird, stellt er das \ Trennzeichen bereit, um die Pfade zu verknüpfen.

Beispiel 2: Kombinieren von Pfaden, die bereits Verzeichnistrennzeichen enthalten

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Vorhandene Verzeichnistrennzeichen \ und verarbeitet, sodass es nur ein Trennzeichen zwischen Path und gibt. ChildPath

Beispiel 3: Anzeigen von Dateien und Ordnern durch Verknüpfen eines Pfads mit einem untergeordneten Pfad

Join-Path "C:\win*" "System*" -Resolve

Mit diesem Befehl werden die Dateien und Ordner angezeigt, auf die durch Verknüpfen des Pfads C:\Win* und des untergeordneten System*-Pfads verwiesen wird. Es werden die gleichen Dateien und Ordner wie Get-ChildItemangezeigt, aber es wird der vollqualifizierte Pfad zu jedem Element angezeigt. In diesem Befehl werden die namen und ChildPath optionalen Path Parameter nicht angegeben.

Beispiel 4: Verwenden Join-Path mit dem PowerShell-Registrierungsanbieter

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Dieser Befehl zeigt die Registrierungsschlüssel im Registrierungsunterschlüssel an, die HKLM\System enthalten ControlSet.

Der Resolve Parameter versucht, den verknüpften Pfad aufzulösen, einschließlich Der Feldhalter aus dem aktuellen Anbieterpfad. HKLM:\

Beispiel 5: Kombinieren mehrerer Pfadstamme mit einem untergeordneten Pfad

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Dieser Befehl verwendet Join-Path , um mehrere Pfadwurzeln mit einem untergeordneten Pfad zu kombinieren.

Hinweis

Die von Path angegebenen Laufwerke müssen vorhanden sein, andernfalls schlägt der Join dieses Eintrags fehl.

Beispiel 6: Kombinieren der Wurzeln eines Dateisystemlaufwerks mit einem untergeordneten Pfad

Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

Dieser Befehl kombiniert die Wurzeln jedes PowerShell-Dateisystemlaufwerks in der Konsole mit dem untergeordneten Subdir-Pfad.

Der Befehl verwendet das Get-PSDrive Cmdlet, um die vom FileSystem-Anbieter unterstützten PowerShell-Laufwerke abzurufen. Die ForEach-Object -Anweisung wählt nur die Root-Eigenschaft der PSDriveInfo Objekte aus und kombiniert sie mit dem angegebenen untergeordneten Pfad.

Die Ausgabe zeigt, dass die PowerShell-Laufwerke auf dem Computer ein Laufwerk enthalten, das dem Verzeichnis C:\Programme zugeordnet ist.

Parameter

-ChildPath

Gibt die Elemente an, die an den Wert des Path Parameters angefügt werden sollen. Platzhalter sind zulässig. Der ChildPath Parameter ist erforderlich, obwohl der Parametername ("ChildPath") optional ist.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Credential

Hinweis

Dieser Parameter wird von keinem Anbieter unterstützt, der mit PowerShell installiert ist. Verwenden Sie Invoke-Command, um die Identität eines anderen Benutzers zu annehmen oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

Gibt die Hauptpfade an, an die der untergeordnete Pfad angefügt wird. Platzhalter sind zulässig.

Der Wert von Path bestimmt, welcher Anbieter die Pfade verknüpft und die Pfadtrennzeichen hinzufügt. Der Path Parameter ist erforderlich, obwohl der Parametername ("Path") optional ist.

Type:String[]
Aliases:PSPath
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Resolve

Gibt an, dass dieses Cmdlet versuchen soll, den verknüpften Pfad vom aktuellen Anbieter aufzulösen.

  • Wenn Feldhalter verwendet werden, gibt das Cmdlet alle Pfade zurück, die mit dem verknüpften Pfad übereinstimmen.
  • Wenn keine Feldhalter verwendet werden, tritt beim Cmdlet ein Fehler auf, wenn der Pfad nicht vorhanden ist.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge, die einen Pfad enthält, an dieses Cmdlet übergeben.

Ausgaben

String

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

Hinweise

Die Cmdlets, die das Substantiv Pfad enthalten (die Pfad-Cmdlets), bearbeiten Pfadnamen und geben die Namen in einem präzisen Format zurück, das alle PowerShell-Anbieter interpretieren können. Diese können in Programmen und Skripts verwendet werden, in denen ein Pfadname vollständig oder teilweise in einem bestimmten Format angezeigt werden soll. Die Verwendung entspricht der von %%amp;quot;Dirname%%amp;quot;, %%amp;quot;Normpath%%amp;quot;, %%amp;quot;Realpath%%amp;quot;, %%amp;quot;Join%%amp;quot; und anderer Befehle zum Bearbeiten von Pfaden.

Sie können die Pfad-Cmdlets mit mehreren Anbietern verwenden, einschließlich der FileSystemAnbieter , Registryund Certificate .

Dieses Cmdlet ist für die Verwendung von Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie ein Get-PSProvider, um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten. Weitere Informationen finden Sie unter about_Providers.