Split-Path
Yolun belirtilen bölümünü döndürür.
Sözdizimi
ParentSet EnterprisePublishing
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
-Leaf
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LeafBaseSet
Split-Path
[-Path] <String[]>
-LeafBase
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
ExtensionSet
Split-Path
[-Path] <String[]>
-Extension
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
-Qualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
-NoQualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
-IsAbsolute
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
Split-Path cmdlet'i üst klasör, alt klasör veya dosya adı gibi bir yolun yalnızca belirtilen bölümünü döndürür. Ayrıca, bölünmüş yol tarafından başvuruda bulunan öğeleri alabilir ve yolun göreli mi yoksa mutlak mı olduğunu söyleyebilir. Başka parametre belirtmeden bir yolu bölerseniz, Split-Path sağlanan yolun üst bölümünü döndürür.
Split-Path komutu dizeleri döndürür. FileInfo döndürmez.
Örnekler
Örnek 1: Bir yolun niteleyicisini alma
Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Bu komut yalnızca yolun niteleyicisini döndürür. Niteleyici sürücüdür.
Örnek 2: Yolun dosya adı bölümünü görüntüleme
Yaprak parametresini kullanırken, Split-Path öğenin bir dosya veya dizin olmasına bakılmaksızın yalnızca sağlanan yol dizesindeki son öğeyi döndürür.
Split-Path -Path .\folder1\*.txt -Leaf
*.txt
Split-Path -Path .\folder1\*.txt -Leaf -Resolve
file1.txt
file2.txt
Çözümle parametresini kullandığınızda, Split-Path sağlanan yol dizesini çözümler ve yol tarafından başvuruda bulunan öğeleri döndürür.
Örnek 3: Üst kapsayıcıyı alma
Üst parametresi kullanılırken Split-Path, sağlanan yol dizesinin yalnızca üst kapsayıcı bölümünü döndürür.
Yolu dizesi üst kapsayıcı içermiyorsa Split-Path boş bir dize döndürür.
Split-Path -Path .\folder1\file1.txt -Parent
.\folder1
Split-Path -Path .\folder1\file1.txt -Parent -Resolve
D:\temp\test\folder1
Çözümle parametresini kullandığınızda, Split-Path sağlanan yol dizesini çözümler ve üst kapsayıcının tam yolunu döndürür.
Örnek 4: Yolun mutlak olup olmadığını belirler
Bu komut, yolun göreli mi yoksa mutlak mı olduğunu belirler. Bu durumda, yol bir nokta (.) ile temsil edilen geçerli klasöre göre olduğundan $falsedöndürür.
Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Örnek 5: Konumu belirtilen yola değiştirme
Bu komut, konumunuzu PowerShell profilini içeren klasöre değiştirir.
PS C:\> Set-Location (Split-Path -Path $PROFILE)
PS C:\Users\User01\Documents\PowerShell>
Parantez içindeki komut, yerleşik Split-Path değişkeninde depolanan yolun yalnızca üst öğesini döndürmek için $PROFILE kullanır.
Üst parametresi varsayılan bölünmüş konum parametresidir.
Bu nedenle, komutundan atlayabilirsiniz. Parantezler PowerShell'i önce komutu çalıştırmaya yönlendirir. Bu, uzun yol adına sahip bir klasöre geçmek için kullanışlı bir yoldur.
Örnek 6: İşlem hattını kullanarak yolu bölme
'C:\Users\User01\My Documents\My Pictures' | Split-Path
C:\Users\User01\My Documents
Bu komut, |yolu göndermek için bir işlem hattı işleci (Split-Path) kullanır. Yol, tek bir belirteç olduğunu belirtmek için tırnak içine alınır.
Parametreler
-Credential
Uyarı
Bu parametre, PowerShell ile yüklenen sağlayıcılar tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| 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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Extension
Bu cmdlet'in yalnızca yaprağın uzantısını döndürdüğünü gösterir. Örneğin, C:\Test\Logs\Pass1.logyolunda yalnızca .logdöndürür.
Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ExtensionSet
| 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 |
-IsAbsolute
Bu cmdlet'in yol mutlaksa $true döndürdüğünü ve göreliyse $false gösterir. Windows'da mutlak yol dizesi, C: veya HKCU:gibi bir sağlayıcı sürücü tanımlayıcısıyla başlamalıdır. Göreli yol nokta (.) veya nokta-nokta (..) ile başlar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
IsAbsoluteSet
| Position: | Named |
| Zorunlu: | True |
| İş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 |
-Leaf
Yaprak parametresini kullanırken, Split-Path öğenin bir dosya veya dizin olmasına bakılmaksızın yalnızca sağlanan yol dizesindeki son öğeyi döndürür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
LeafSet
| 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 |
-LeafBase
Bu cmdlet'in yaprağın yalnızca temel adını döndürdüğünü gösterir. Örneğin, C:\Test\Logs\Pass1.logyolunda yalnızca Pass1döndürür.
Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
LeafBaseSet
| 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 |
-LiteralPath
Bölünecek yolları belirtir. Path'in aksine, LiteralPath 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralPathSet
| 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 |
-NoQualifier
Bu cmdlet'in niteleyici olmadan yolu döndürdüğünü gösterir. FileSystem veya kayıt defteri sağlayıcıları için niteleyici, C: veya HKCU:gibi sağlayıcı yolunun sürücüsüdür. Örneğin, C:\Test\Logs\Pass1.logyolunda yalnızca \Test\Logs\Pass1.logdöndürür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NoQualifierSet
| 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 |
-Parent
Split-Path, sağlanan yol dizesinin yalnızca üst kapsayıcı bölümünü döndürür.
Yolu dizesi üst kapsayıcı içermiyorsa Split-Path boş bir dize döndürür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ParentSet
| Position: | Named |
| Zorunlu: | False |
| İş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
Bölünecek yolları belirtir. Joker karakterlere izin verilir. Dosya yolu boşluk içeriyorsa, tırnak işareti içine alın. Bu cmdlet'e bir yol da ekleyebilirsiniz.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
ParentSet
| 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 |
LeafSet
| 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 |
LeafBaseSet
| 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 |
ExtensionSet
| 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 |
QualifierSet
| 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 |
NoQualifierSet
| 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 |
IsAbsoluteSet
| 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 |
-Qualifier
Bu cmdlet'in yalnızca belirtilen yolun niteleyicisini döndürdüğünü gösterir. FileSystem veya Kayıt Defteri sağlayıcıları için niteleyici, C: veya HKCU:gibi sağlayıcı yolunun sürücüsüdür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
QualifierSet
| Position: | 1 |
| 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 |
-Resolve
Bu cmdlet'in yol öğelerini görüntülemek yerine sonuçta elde edilen bölünmüş yol tarafından başvuruda bulunan öğeleri görüntülediğini gösterir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| 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 |
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
Bu cmdlet'e bir yolu içeren bir dizeyi aktarabilirsiniz.
Çıkışlar
String
Bu cmdlet metin dizeleri döndürür. Çözümle parametresini belirttiğinizde, öğelerin konumunu açıklayan bir dize döndürür. FileInfo veya RegistryKey nesnesi gibi öğeleri temsil eden nesneler döndürmez.
Boolean
isAbsolute parametresini belirttiğinizde, bu cmdlet bir Boole değeri döndürür.
Notlar
Bölme konumu parametreleri (Niteleyici, Üst, Uzantı, Yaprak, LeafBaseve NoQualifier) özeldir. Her komutta yalnızca bir tane kullanabilirsiniz.
Yol adını içeren cmdlet'ler (Yolu cmdlet'leri) yol adlarıyla çalışır ve adları tüm PowerShell sağlayıcılarının yorumlayabildiği kısa bir biçimde döndürür. Bir yol adının 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. Bunları Dirname, Normpath, Realpath, Joinveya diğer yol manipülatörleri gibi kullanın.
Yolu cmdlet'lerini çeşitli sağlayıcılarla birlikte kullanabilirsiniz. Bunlar FileSystem, Registry ve Sertifika sağlayıcılarını içerir.
Split-Path, herhangi bir sağlayıcı tarafından sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek içinGet-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.
