Aracılığıyla paylaş

Convert-Path

Modül:
Microsoft.PowerShell.Management Module

Bir yolu PowerShell yolundan PowerShell sağlayıcı yoluna dönüştürür.

Syntax

Path (Varsayılan) 

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

LiteralPath 

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

Description

Convert-Path cmdlet'i, bir yolu PowerShell yolundan PowerShell sağlayıcı yoluna dönüştürür.

Örnekler

Örnek 1: Çalışma dizinini standart dosya sistemi yoluna dönüştürme

Bu örnek, nokta (.) ile gösterilen geçerli çalışma dizinini standart bir FileSystem yoluna dönüştürür.

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

Örnek 2: Sağlayıcı yolunu standart kayıt defteri yoluna dönüştürme

Bu örnek, PowerShell sağlayıcı yolunu standart bir kayıt defteri yoluna dönüştürür.

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

Örnek 3: Yolu dizeye dönüştürme

Bu örnek, geçerli sağlayıcı olan FileSystem sağlayıcısının ana dizin yolunu bir dizeye dönüştürür.

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

Örnek 4: Gizli öğeler için yolları dönüştürme

Varsayılan olarak, Convert-Path gizli öğeleri döndürmez. Bu örnekte gizli öğeleri bulmak için Zorla parametresi kullanılır. Get-Item komutu, .git klasörünün gizlendiğini onaylar. Convert-Path parametresi olmadan kullanılması yalnızca görünür öğeleri döndürür. Zorla parametresinin eklenmesi, gizli öğeler de dahil olmak üzere tüm öğeleri döndürür.

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

Parametreler

-Force

Cmdlet'in gizli veya sistem dosyaları gibi kullanıcı tarafından erişilmeyen öğeleri almasına izin verir. Güç parametresi güvenlik kısıtlamalarını geçersiz kılmaz. Uygulama, sağlayıcılar arasında farklılık gösterir. Daha fazla bilgi için bkz. about_Providers.

Bu parametre PowerShell 7.5-preview.5'e eklendi.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-LiteralPath

Dönüştürülecek yolu dize dizisi olarak belirtir. LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.

Daha fazla bilgi için bkz. about_Quoting_Rules.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:PSPath, LP

Parametre kümeleri

LiteralPath
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

Dönüştürülecek PowerShell yolunu belirtir.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

Path
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Bir yolu bu cmdlet'e yöneltebilirsiniz, ancak değişmez olmayan bir yol belirtemezsiniz.

Çıkışlar

String

Bu cmdlet dönüştürülen yolu içeren bir dize döndürür.

Notlar

PowerShell, Convert-Pathiçin aşağıdaki diğer adları içerir:

  • Tüm platformlar:
    • cvpa

Yol adını içeren cmdlet'ler yol adlarını işleyip adları tüm PowerShell sağlayıcılarının yorumlayabildiği kısa bir biçimde döndürür. Bir yolun tamamını veya bir bölümünü belirli bir biçimde görüntülemek istediğiniz programlarda ve betiklerde kullanılmak üzere tasarlanmıştır. Dirname, Normpath, Realpath, Joinveya diğer yol manipülatörleri gibi kullanın.

FileSystem, Kayıt Defterive Sertifika sağlayıcıları dahil olmak üzere çeşitli sağlayıcılarla yol cmdlet'lerini kullanabilirsiniz.

Bu cmdlet, herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.

Convert-Path yalnızca var olan yolları dönüştürür. Henüz var olmayan bir konumu dönüştürmek için kullanılamaz.