Split-Path (Microsoft.PowerShell.Management)

Split-Path

Modül:
Microsoft.PowerShell.Management

Yolun belirtilen kısmını döndürür.

Sözdizimi

Split-Path
     [-Path] <String[]>
     [-Parent]
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -Leaf
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -LeafBase
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -Extension
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -Qualifier
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -NoQualifier
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Resolve]
     -IsAbsolute
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     -LiteralPath <String[]>
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]

Tanım

Split-Path cmdlet'i, ana klasör, alt klasör veya dosya adı gibi yolun yalnızca belirtilen kısmını döndürür. Ayrıca bölünmüş yolun referans verdiği öğeleri de alabilir ve yolun göreceli mi yoksa mutlak mı olduğunu söyleyebilir.

Bu cmdlet'i bir yolun yalnızca seçilen bir bölümünü almak veya göndermek için kullanabilirsiniz.

Örnekler

Örnek 1: Bir yolun niteleyicisini alın

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üş yolun başvuruda bulunduğu dosyaları görüntüler. Bu yol, yaprak olarak da bilinen son öğeye bölündüğü için komut yalnızca dosya adlarını görüntüler.

Çözümle parametresi, Bölünmüş Yol'a bölünmüş yolu görüntülemek yerine bölünmüş yolun referans verdiği öğeleri görüntülemesini söyler.

Tüm Bölünmüş Yol komutları gibi, bu komut da dizeleri döndürür. Dosyaları temsil eden FileInfo nesnelerini döndürmez.

Örnek 3: Ana kapsayıcıyı alın

Split-Path -Parent "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ölünmüş Yol, bölmeyi belirtmek için herhangi bir parametre içermediğinden, Üst olan bölme konumu varsayılanını kullanır.

Örnek 4: Bir yolun mutlak olup olmadığını belirler

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

False

Bu komut yolun göreceli mi mutlak mı olduğunu belirler. Bu durumda yol, bir noktayla (.) gösterilen geçerli klasöre göreli olduğundan, $False değerini döndürür.

Örnek 5: Konumu belirli bir yolla değiştirin

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 $Profile değişkeninde depolanan yolun yalnızca üst öğesini döndürmek için Bölünmüş Yol'u kullanır. Parent parametresi varsayılan bölünmüş konum parametresidir. Bu nedenle onu komuttan çıkarabilirsiniz. Parantez, PowerShell'i önce komutu çalıştırmaya yönlendirir. Bu, yol adı uzun olan bir klasöre gitmenin kullanışlı bir yoludur.

Ö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, Split-Path'e yol göndermek için bir ardışık düzen operatörü (|) kullanır. Yol, tek bir belirteç olduğunu belirtmek için tırnak işaretleri içine alınır.

Parametreler

-Credential

Not

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-Command'ı kullanın.

Tip :

PSC kimlik bilgisi

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Extension

Bu cmdlet'in yalnızca yaprağın uzantısını döndürdüğünü belirtir. Örneğin, C:\Test\Logs\Pass1.log yolunda yalnızca .log değerini döndürür.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-IsAbsolute

Bu cmdlet'in, yol mutlaksa $True, göreceliyse $False döndürdüğünü belirtir. Mutlak yolun uzunluğu sıfırdan büyüktür ve geçerli yolu belirtmek için nokta (.) kullanılmaz.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Leaf

Bu cmdlet'in yalnızca yoldaki son öğeyi veya kapsayıcıyı döndürdüğünü belirtir. Örneğin, C:\Test\Logs\Pass1.log yolunda yalnızca Pass1.log değerini döndürür.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-LeafBase

Bu cmdlet'in yalnızca yaprağın temel adını döndürdüğünü belirtir. Örneğin, C:\Test\Logs\Pass1.log yolunda yalnızca Pass1 değerini döndürür.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-LiteralPath

Bölünecek yolları belirtir. Path'ten farklı olarak LiteralPath'in değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmaz. Yol kaçış karakterleri içeriyorsa, onu tek tırnak işaretleri içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamamasını söyler.

Tip :

String[]

Takma adlar:

PSPath, LP

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-NoQualifier

Bu cmdlet'in niteleyici olmadan yolu döndürdüğünü belirtir. FileSystem veya kayıt 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.log yolunda yalnızca \Test\Logs\Pass1.log değerini döndürür.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

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ü belirtir. Örneğin, C:\Test\Logs\Pass1.log yolunda C:\Test\Logs değerini döndürür. Parent parametresi varsayılan bölünmüş konum parametresidir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Path

Bölünecek yolları belirtir. Joker karakterlere izin verilir. Yol boşluk içeriyorsa, onu tırnak işaretleri içine alın. Ayrıca bu cmdlet'e giden yolu da yönlendirebilirsiniz.

Tip :

String[]

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-Qualifier

Bu cmdlet'in yalnızca belirtilen yolun niteleyicisini döndürdüğünü belirtir. FileSystem veya kayıt sağlayıcıları için niteleyici, C: veya HKCU: gibi sağlayıcı yolunun sürücüsüdür.

Tip :

SwitchParameter

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Resolve

Bu cmdlet'in yol öğelerini görüntülemek yerine, sonuçtaki bölünmüş yolun başvuruda bulunduğu öğeleri görüntülediğini belirtir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Dize

Bu cmdlet'in yolunu içeren bir dizeyi yönlendirebilirsiniz.

Çıkışlar

Dize

Bu cmdlet metin dizelerini 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 nesneleri döndürmez.

Boole

IsAbsolute parametresini belirttiğinizde bu cmdlet bir Boolean değeri döndürür.

Notlar

  • Bölünmüş konum parametreleri (Niteleyici, Üst, Uzantı, Yaprak, YaprakBase, ve NoQualifier) özeldir. Her komutta yalnızca birini kullanabilirsiniz.

  • Path adını içeren cmdlet'ler (Path cmdlet'leri) yol adlarıyla çalışır ve adları tüm PowerShell sağlayıcılarının yorumlayabileceği kısa bir biçimde döndürür. Yol adının tamamını veya bir kısmını belirli bir biçimde görüntülemek istediğiniz programlarda ve komut dosyalarında kullanılmak üzere tasarlanmıştır. Bunları Dirname, Normpath, Realpath, Join veya diğer yol düzenleyicileri kullandığınız şekilde kullanın.

  • Path cmdlet'lerini çeşitli sağlayıcılarla birlikte kullanabilirsiniz. Bunlara Dosya Sistemi, Kayıt Defteri ve Sertifika sağlayıcıları dahildir.

  • Split-Path herhangi bir sağlayıcının açığa çıkardığı verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda mevcut olan sağlayıcıları listelemek için Get-PSProvider yazın. Daha fazla bilgi için bkz. about_Providers.

İlgili makaleler