Aracılığıyla paylaş

Split-Path

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

Yolun belirtilen bölümü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>]

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

komutu Split-Path dizeleri döndürür. FileInfo.

Ö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

Leaf parametresini kullanırken, Split-Path bu öğenin bir dosya veya dizin olmasına bakılmaksızın, sağlanan yol dizesindeki yalnızca son öğeyi döndürür.

Split-Path -Path .\folder1\*.txt -Leaf

*.txt

Split-Path -Path .\folder1\*.txt -Leaf -Resolve

file1.txt
file2.txt

Resolve 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

Parent parametresini kullanırken, Split-Path sağlanan yol dizesinin yalnızca üst kapsayıcı bölümünü döndürür. Yol dizesi üst kapsayıcı içermiyorsa boş Split-Path 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

Resolve 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 döndürür $false.

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şkende depolanan yolun yalnızca üst öğesini döndürmek için kullanır$PROFILE. Parent 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 adresine yol |göndermek için işlem hattı işlecini (Split-Path) 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 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-Command kullanın.

Tür:PSCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-IsAbsolute

Bu cmdlet'in yol mutlaksa ve $true göreliyse döndürdüğünü $false gösterir. Windows'ta, mutlak yol dizesi veya C:gibi HKCU: 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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Leaf

Leaf parametresini kullanırken, Split-Path bu öğenin bir dosya veya dizin olmasına bakılmaksızın, sağlanan yol dizesindeki yalnızca son öğeyi döndürür.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:String[]
Diğer adlar:PSPath, LP
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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 C:gibi HKCU: 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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Parent

Split-Path , sağlanan yol dizesinin yalnızca üst kapsayıcı bölümünü döndürür. Yol dizesi üst kapsayıcı içermiyorsa boş Split-Path bir dize döndürür.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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 ekleyebilirsiniz.

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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, C: veya HKCU:gibi sağlayıcı yolunun sürücüsüdür.

Tür:SwitchParameter
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 nesneler döndürmez.

Boolean

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

Notlar

  • Bölünmüş konum 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, Registry 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.