Split-Path

Modül:

Microsoft.PowerShell.Management Module

Yolun belirtilen bölümünü döndürür.

Syntax

ParentSet (Varsayılan)

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

Cmdlet, ü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.

Yolun yalnızca seçili bir bölümünü almak veya göndermek için bu cmdlet'i kullanabilirsiniz.

Ö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: Dosya adlarını görüntüleme

Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve

Pass1.log
Pass2.log
...

Bu komut, bölünmüş yol tarafından başvuruda bulunan dosyaları görüntüler. Bu yol yaprak olarak da bilinen son öğeye bölündüğünden, komut yalnızca dosya adlarını görüntüler.

Resolve parametresi, bölünmüş yolu görüntülemek yerine bölünmüş yolun başvurduğu öğelerin görüntülenmesini söylerSplit-Path.

Tüm Split-Path komutlar gibi, bu komut da dizeleri döndürür. Dosyaları temsil eden FileInfo nesneleri döndürmez.

Örnek 3: Üst kapsayıcıyı alma

Split-Path -Path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"

C:\WINDOWS\system32\WindowsPowerShell\V1.0

Bu komut yalnızca yolun üst kapsayıcılarını döndürür. Bölmeyi belirtmek için herhangi bir parametre içermediğinden, Split-PathÜst olan bölme konumu varsayılanını kullanır.

Örnek 4: Yolun mutlak olup olmadığını belirler

Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute

False

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.

Örnek 5: Konumu belirtilen yola değiştirme

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>

Bu komut, konumunuzu PowerShell profilini içeren klasöre değiştirir.

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:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path

C:\Documents and Settings\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 hiçbir sağlayıcı 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

Yolun mutlak olup olmadığını ve göreli olup olmadığını $False bu cmdlet'in döndüğünü $True gösterir. Mutlak yolun uzunluğu sıfırdan büyüktür ve geçerli yolu belirtmek için nokta (.) kullanmaz.

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

Bu cmdlet'in yalnızca yoldaki son öğeyi veya kapsayıcıyı döndürdüğünü gösterir. Örneğin, C:\Test\Logs\Pass1.logyolunda yalnızca Pass1.log 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

Bu cmdlet'in yalnızca öğenin veya yol tarafından belirtilen kapsayıcının üst kapsayıcılarını döndürdüğünü gösterir. Örneğin, yolda C:\Test\Logs\Pass1.log, döndürür C:\Test\Logs. Üst parametresi varsayılan bölünmüş konum parametresidir.

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

System.String, System.Boolean

Split-Path Metin dizelerini döndürür. Resolve parametresini belirttiğinizde, Split-Path öğelerin konumunu açıklayan bir dize döndürür; FileInfo veya RegistryKey nesnesi gibi öğeleri temsil eden nesneleri döndürmez.

IsAbsolute parametresini belirttiğinizde, Split-Path 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çin Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.

İlişkili Bağlantılar

• Convert-Path
• Join-Path
• Resolve-Path
• Test-Path