Join-Path
Kombiniert einen Pfad und einen untergeordneten Pfad zu einem Pfad.
Syntax
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Beschreibung
Das Join-Path
Cmdlet kombiniert einen Pfad und einen untergeordneten Pfad in 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 verbinden.
Beispiel 2: Kombinieren von Pfaden, die bereits Verzeichnistrennzeichen enthalten
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Vorhandene Verzeichnistrennzeichen \
und werden behandelt, sodass nur ein Trennzeichen zwischen Path
und ChildPath
Beispiel 3: Anzeigen von Dateien und Ordnern durch Verknüpfen eines Pfads mit einem untergeordneten Pfad
Join-Path "C:\win*" "System*" -Resolve
Dieser Befehl zeigt die Dateien und Ordner an, auf die verwiesen wird, indem der Pfad C:\Win* und der untergeordnete Pfad System* hinzugefügt werden.
Es werden die gleichen Dateien und Ordner wie Get-ChildItem
angezeigt, aber es wird der vollqualifizierte Pfad zu jedem Element angezeigt.
In diesem Befehl werden die Path
optionalen Parameternamen und ChildPath
weggelassen.
Beispiel 4: Verwenden von 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 Wildcards aus dem aktuellen Anbieterpfad. HKLM:\
Beispiel 5: Kombinieren mehrerer Pfadwurzeln 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 Stammelemente 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.
Beispiel 7: Kombinieren einer unbegrenzten Anzahl von Pfaden
Join-Path a b c d e f g
a\b\c\d\e\f\g
Der AdditionalChildPath
Parameter ermöglicht das Verknüpfen einer unbegrenzten Anzahl von Pfaden.
In diesem Beispiel werden keine Parameternamen verwendet. Daher wird "a" an Path
, "b" an ChildPath
und "c-g" an AdditionalChildPath
Parameter
-AdditionalChildPath
Gibt zusätzliche Elemente an, die an den Wert des Path-Parameters angefügt werden sollen. Der ChildPath
Parameter ist weiterhin obligatorisch und muss ebenfalls angegeben werden.
Dieser Parameter wird mit der ValueFromRemainingArguments
-Eigenschaft angegeben, die das Verknüpfen einer unbegrenzten Anzahl von Pfaden ermöglicht.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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 anbietern, die mit PowerShell installiert sind, nicht unterstützt. 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 Wildcards verwendet werden, gibt das Cmdlet alle Pfade zurück, die dem verknüpften Pfad entsprechen.
- Wenn keine Wildcards verwendet werden, gibt das Cmdlet einen Fehler aus, wenn der Pfad nicht vorhanden ist.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können eine Zeichenfolge, die einen Pfad enthält, an dieses Cmdlet übergeben.
Ausgaben
Dieses Cmdlet gibt eine Zeichenfolge zurück, die den resultierenden Pfad enthält.
Hinweise
Die Cmdlets, die das Pfad-Substantiv (die Pfad-Cmdlets) enthalten, 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 FileSystem
Anbieter , Registry
und Certificate
.
Dieses Cmdlet ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden.
Um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten, geben Sie ein Get-PSProvider
.
Weitere Informationen finden Sie unter about_Providers.