Aracılığıyla paylaş

Format-List

Modül:
Microsoft.PowerShell.Utility Module

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

Sözdizimi

Default EnterprisePublishing 

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, bilgisayardaki hizmetleri temsil eden nesneleri alır. İşlem hattı operatörü (|), sonuçları işlem hattı üzerinden 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. İşlem hattı operatörü (|), işlem nesnelerini işlem hattı üzerinden Format-List'ye 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ı operatörü (|), Winlogon işlem nesnesini işlem hattı aracılığıyla Format-List'e iletir. 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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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 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.

Parametre özellikleri

Tür:String
Default value:None
Kabul edilen değerler:CoreOnly, EnumOnly, Both
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Force

Bu cmdlet'in tüm hata bilgilerini görüntülediğini gösterir. DisplayError veya ShowError parametresini kullanın. Varsayılan olarak, bir hata nesnesi hata veya görüntü akışlarına yazıldığında, 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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Object
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-InputObject

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

Parametre özellikleri

Tür:PSObject
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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 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.

Parametre özellikleri

Tür:

Object[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.