Aracılığıyla paylaş

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.

Sözdizimi

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

Description

Format-List cmdlet'i, 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 olarak biçimlendirmek ve görüntülemek için Format-List kullanabilirsiniz (Format-List -Property *).

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. Get-Service cmdlet'i, bilgisayardaki hizmetleri temsil eden nesneleri getirir. İşlem hattı operatörü (|), sonuçları Format-List'e geçirir. Ardından, Format-List komutu 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ı $A değişkeninde depolar.

İkinci komut, Format-Listiçinde depolanan nesneler hakkındaki bilgileri biçimlendirmek için $A kullanır. Bu komut, değişkeni geçirmek için Format-List parametresini kullanır ve ardından biçimlendirilmiş çıkışı görüntüleme için varsayılan çıktı 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 Get-Process cmdlet'ini kullanır. İş hattı operatörü (|), süreç nesnelerini boru hattından Format-List'e geçirir. Format-List, işlemleri belirtilen özelliklerin listesi olarak biçimlendirmektedir. Özelliği parametre 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 Format-List'e aktarır. komutu, özellikleri belirtmek için Özelliği parametresini ve tüm özellikleri belirtmek için * kullanır. Özelliği parametresinin adı isteğe bağlı olduğundan, bunu atlayabilir ve komutunu Format-List *olarak 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 komutunda ifadeleri biçimlendirirken hata ayıklama yardımı olarak kullanılabilir ve ifadeler çalışmıyor gibi görünür.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 EnumOnly. Bu parametre için kabul edilebilir değerler ş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.
Tür:String
Kabul edilen değerler:CoreOnly, EnumOnly, Both
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Bu cmdlet'in tüm hata bilgilerini görüntülediğini gösterir. veya parametresi ile DisplayError ya da ShowError kullanın. Varsayılan olarak, bir hata nesnesi hata veya gösterim akışlarına yazıldığında, yalnızca bazı hata bilgileri gösterilir.

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 parametresi nesnelerin sıralanmasını bekler. Nesneleri gruplandırmak için Sort-Object kullanmadan önce Format-List cmdlet'ini kullanın.

GroupBy parametresinin değeri yeni bir hesaplanan özellik olabilir. Hesaplanan özellik bir komut dosyası 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, about_Calculated_Propertiesbölümüne bakın.

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

-InputObject

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

Tür:PSObject
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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. parametre adı, Özellik için isteğe bağlıdır. Aynı komutta Özelliği ve Görünüm parametrelerini kullanamazsınız.

Özelliği parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir komut dosyası 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, about_Calculated_Propertiesbölümüne bakın.

Tür:Object[]
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-ShowError

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

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

-View

Alternatif liste biçiminin veya görünümünün adını belirtir. Aynı komutta Özelliği ve Görünüm parametrelerini kullanamazsınız.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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, Format-Listiçin aşağıdaki diğer adları içerir:

  • Tüm platformlar:
    • fl

Format-Listgibi biçim cmdlet'leri, görüntülenecek verileri düzenler ancak görüntülemez. Veriler PowerShell'in çıkış özellikleri ve Out veya Outgibi Out-Host fiilini (Out-File cmdlet'leri) içeren 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.

Görünüm parametresi, tablo için alternatif bir biçim belirtmenize olanak tanır. PowerShell dizinindeki *.format.ps1xml dosyalarında 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 Update-FormatData cmdlet'ini kullanabilirsiniz.

Görünüm 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 Format-Tablekullanın. Alternatif görünüm bir liste veya tablo değilse Format-Customkullanın.

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

  • Giriş nesneleri, ToString() yöntemi kullanılarak bant dışı biçimlendirilir. Bu, [string], [int]ve diğerleri gibi yerleşik sayısal türlerin üst kümesi olan [long] ve .NET temel türleri için geçerlidir.

  • Giriş nesnelerinin genel özellikleri yoktur.

  • Giriş nesneleri, PowerShell'in Başarı çıkış akışı dışındaki çıkış akışları için kullandığı sarmalayıcı türlerinin örnekleridir. Bu, yalnızca bu sarmalayıcı türleri Başarı çıkış akışına gönderildiğinde geçerlidir. Bu, bunları önce ErrorVariable gibi ortak parametreler aracılığıyla veya *>&1gibi bir yeniden yönlendirme kullanarak yakalamayı gerektirir.