Format-List

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

Çıkışı, her özelliğin yeni bir satırda görüntülendiği özelliklerin listesi olarak biçimlendirır.

Syntax

Format-List
      [[-Property] <Object[]>]
      [-GroupBy <Object>]
      [-View <string>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>]
      [<CommonParameters>]

Description

cmdlet'i Format-List bir komutun çıkışını, her özelliğin ayrı bir satırda görüntülendiği özelliklerin listesi olarak biçimlendirır. Bir nesnenin tüm veya seçili özelliklerini liste (Format-List -Property *) olarak biçimlendirmek ve görüntülemek için kullanabilirsinizFormat-List.

Listedeki her öğe için tabloya göre daha fazla alan olduğundan, PowerShell listedeki nesnenin daha fazla özelliğini görüntüler ve özellik değerlerinin kesilmesi daha az olasıdır.

Örnekler

Örnek 1: Bilgisayar hizmetlerini biçimlendirme

Get-Service | Format-List

Bu komut, bilgisayardaki hizmetlerle ilgili bilgileri liste olarak biçimlendirer. Varsayılan olarak, hizmetler tablo olarak biçimlendirilir. cmdlet'i Get-Service bilgisayardaki hizmetleri temsil eden nesneleri alır. İşlem hattı işleci (|), sonuçları işlem hattı üzerinden öğesine Format-Listgeçirir. Ardından komut, Format-List bir listedeki hizmet bilgilerini biçimlendirip görüntülemek üzere varsayılan çıktı cmdlet'ine gönderir.

Örnek 2: PS1XML dosyalarını biçimlendirme

Bu komutlar, PowerShell dizinindeki PS1XML dosyaları hakkındaki bilgileri liste olarak görüntüler.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

İlk komut, dosyaları temsil eden nesneleri alır ve bunları değişkende $A depolar.

İkinci komut, içinde depolanan nesneler hakkındaki bilgileri biçimlendirmek $Aiçin kullanırFormat-List. Bu komut, değişkenini Format-Listöğesine geçirmek için InputObject parametresini kullanır ve ardından biçimlendirilmiş çıkışı görüntüleme için varsayılan çıkış cmdlet'ine gönderir.

Örnek 3: İşlem özelliklerini ada göre biçimlendirme

Bu komut, bilgisayardaki her işlemin adını, temel önceliğini ve öncelik sınıfını görüntüler.

Get-Process | Format-List -Property Name, BasePriority, PriorityClass

Her işlemi temsil eden bir nesne almak için cmdlet'ini kullanır Get-Process . İşlem hattı işleci (|), işlem hattı üzerinden işlem nesnelerini öğesine Format-Listgeçirir. Format-List işlemleri belirtilen özelliklerin listesi olarak biçimlendirmektedir. Özellik parametresi adı isteğe bağlıdır, bu nedenle atlayabilirsiniz.

Örnek 4: bir işlemin tüm özelliklerini biçimlendirme

Bu komut Winlogon işleminin tüm özelliklerini görüntüler.

Get-Process winlogon | Format-List -Property *

Winlogon işlemini temsil eden bir nesne almak için Get-Process cmdlet'ini kullanır. İşlem hattı işleci (|), winlogon işlem nesnesini işlem hattı üzerinden öğesine Format-Listgeçirir. komutu, özellikleri belirtmek için Property parametresini ve tüm özellikleri belirtmek için parametresini * kullanır. Property parametresinin adı isteğe bağlı olduğundan, parametresini atlayabilir ve komutunu olarak Format-List *yazabilirsiniz. Format-List sonuçları otomatik olarak görüntü için varsayılan çıkış cmdlet'ine gönderir.

Örnek 5: Biçim hatalarını giderme

Aşağıdaki örneklerde, bir ifadeyle DisplayError veya ShowError parametrelerini eklemenin sonuçları gösterilmektedir.

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parametreler

-DisplayError

Bu cmdlet'in komut satırında hataları görüntülediğini gösterir. Bu parametre nadiren kullanılır, ancak bir Format-List komuttaki ifadeleri biçimlendirirken hata ayıklama yardımı olarak kullanılabilir ve ifadeler çalışmıyor gibi görünür.

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

-Expand

Biçimlendirilmiş koleksiyon nesnesini ve koleksiyondaki nesneleri belirtir. Bu parametre System.Collections.ICollection arabirimini destekleyen nesneleri biçimlendirmek için tasarlanmıştır. Varsayılan değer şudur: EnumOnly. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • EnumOnly. Koleksiyondaki nesnelerin özelliklerini görüntüler.
  • CoreOnly. Koleksiyon nesnesinin özelliklerini görüntüler.
  • Both. Koleksiyon nesnesinin özelliklerini ve koleksiyondaki nesnelerin özelliklerini görüntüler.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Bu cmdlet'in tüm hata bilgilerini görüntülediğini gösterir. DisplayError veya ShowError parametresiyle kullanın. Varsayılan olarak, hataya bir hata nesnesi yazıldığında veya akış görüntülendiğinde yalnızca bazı hata bilgileri görüntülenir.

Ayrıca, belirli .NET türlerini biçimlendirirken de gereklidir. Daha fazla bilgi için Notlar bölümüne bakın.

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

-GroupBy

Paylaşılan bir özelliğe veya değere göre gruplarda çıktıyı belirtir. Çıkışın bir ifadesini veya özelliğini girin.

GroupBy parametresinin değeri yeni bir hesaplanan özellik olabilir. Hesaplanan özellik bir betik bloğu veya karma tablo olabilir. Geçerli anahtar-değer çiftleri şunlardır:

  • Name (veya Label) - <string>
  • Expression - <string> veya <script block>
  • FormatString - <string>

Daha fazla bilgi için bkz . about_Calculated_Properties.

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

-InputObject

Biçimlendirilecek nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.

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

-Property

Görüntüde görüntülenen nesne özelliklerini ve bunların görüntülenme sırasını belirtir. Joker karakterlere izin verilir.

Bu parametreyi atlarsanız, ekranda görünen özellikler görüntülenen nesneye bağlıdır. Özellik parametre adı isteğe bağlıdır. Özellik ve Görünüm parametrelerini aynı komutta kullanamazsınız.

Property parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir betik bloğu veya karma tablo olabilir. Geçerli anahtar-değer çiftleri şunlardır:

  • Name (veya Label) - <string>
  • Expression - <string> veya <script block>
  • FormatString - <string>

Daha fazla bilgi için bkz . about_Calculated_Properties.

Type:Object[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowError

Cmdlet'in işlem hattı üzerinden hata gönderdiğini gösterir. Bu parametre nadiren kullanılır, ancak bir Format-List komuttaki ifadeleri biçimlendirirken hata ayıklama yardımı olarak kullanılabilir ve ifadeler çalışmıyor gibi görünür.

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

-View

Alternatif liste biçiminin veya görünümünün adını belirtir. Özellik ve Görünüm parametrelerini aynı komutta kullanamazsınız.

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

Girişler

PSObject

Herhangi bir nesneyi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

Microsoft.PowerShell.Commands.Internal.Format

Bu cmdlet, listeyi temsil eden biçim nesnelerini döndürür.

Notlar

PowerShell için aşağıdaki diğer adları Format-Listiçerir:

  • Tüm platformlar:
    • fl

gibi Format-Listbiçim cmdlet'leri, görüntülenecek verileri düzenler ancak görüntülemez. Veriler, PowerShell'in çıkış özellikleri ve veya Out-Filegibi Out-Host fiili (Outcmdlet'ler) içeren Out cmdlet'ler tarafından görüntülenir.

Biçim cmdlet'i kullanmıyorsanız PowerShell, görüntülediği her nesne için bu varsayılan biçimi uygular.

GroupBy parametresi, nesnelerin sıralandığını varsayar. Kullanarak nesneleri gruplandırmadan önce Format-List kullanınSort-Object.

View parametresi, tablo için alternatif bir biçim belirtmenize olanak tanır. PowerShell dizinindeki dosyalarda *.format.PS1XML tanımlanan görünümleri kullanabilir veya yeni PS1XML dosyalarında kendi görünümlerinizi oluşturabilir ve bunları PowerShell'e eklemek için cmdlet'ini Update-FormatData kullanabilirsiniz.

View parametresinin alternatif görünümü liste biçimini kullanmalıdır, aksi takdirde komut başarısız olur. Alternatif görünüm bir tabloysa kullanın Format-Table. Alternatif görünüm bir liste veya tablo değilse kullanın Format-Custom.

Property parametresiyle kullanmak Format-List istiyorsanız, Aşağıdaki koşullardan herhangi birine Force parametresini eklemeniz gerekir: