Split-Path

  • Başvuru
Modül:
Microsoft.PowerShell.Management

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

Syntax

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>]

Description

Split-Path Cmdlet, üst klasör, alt klasör veya dosya adı gibi yolun yalnızca belirtilen bölümünü döndürür. Ayrıca, bölünmüş yol tarafından başvuruda bulunup 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ölme yolunu görüntülemek yerine bölme yolunun başvurduğunu öğeleri görüntülemesini söylerSplit-Path.

Tüm Split-Path komutlar gibi bu komut da dizeleri döndürür. Dosyaları temsil eden FileInfo nesnelerini 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 döndürür $False.

Ö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 komutu, yerleşik $Profile değişkende depolanan yolun yalnızca üst öğesini döndürmek için kullanırSplit-Path. Ü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çmenin 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 adresine yol Split-Pathgöndermek için bir işlem hattı işleci (|) kullanır. Yol, tek bir belirteç olduğunu belirtmek için tırnak 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.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Extension

Bu cmdlet'in yalnızca yaprağın uzantısını döndürdüğünü gösterir. Örneğin, yolunda C:\Test\Logs\Pass1.logyalnızca .logdöndürür.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-IsAbsolute

Bu cmdlet'in yol mutlaksa ve $False göreliyse döndürdüğünü $True gösterir. Mutlak yolun uzunluğu sıfırdan büyük ve geçerli yolu belirtmek için nokta (.) kullanmaz.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Leaf

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LeafBase

Bu cmdlet'in yaprağın yalnızca temel adını döndürdüğünü gösterir. Örneğin, yolunda C:\Test\Logs\Pass1.logyalnızca Pass1döndürür.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Bölünecek yolları belirtir. Yol'un 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, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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, veya HKCU:gibi C: sağlayıcı yolunun sürücüsüdür. Örneğin, yolunda C:\Test\Logs\Pass1.logyalnızca \Test\Logs\Pass1.logdöndürür.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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, yolunda C:\Test\Logs\Pass1.logdöndürür C:\Test\Logs. Üst parametresi varsayılan bölünmüş konum parametresidir.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Bölünecek yolları belirtir. Joker karakterlere izin verilir. Yol boşluk içeriyorsa, tırnak içine alın. Bu cmdlet'e bir yol da yöneltebilirsiniz.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-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, veya HKCU:gibi C: sağlayıcı yolunun sürücüsüdür.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

String

Bu cmdlet metin dizeleri döndürür. Resolve 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.

Boolean

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

Notlar

  • Bölme konumu parametreleri (Niteleyici, Üst, Uzantı, Yaprak, Yaprak Tabanı ve NoQualifier) özeldir. Her komutta yalnızca bir tane kullanabilirsiniz.

  • Yol adını (Yol cmdlet'leri) içeren cmdlet'ler 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, Join veya diğer yol manipülatörlerini kullandığınız şekilde kullanın.

  • Path cmdlet'lerini çeşitli sağlayıcılarla birlikte kullanabilirsiniz. Bunlar FileSystem, Kayıt Defteri ve Sertifika sağlayıcılarını içerir.

  • Split-Path 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 yazın Get-PSProvider. Daha fazla bilgi için bkz. about_Providers.