Format-Wide

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

Nesneleri, her nesnenin yalnızca bir özelliğini görüntüleyen geniş bir tablo olarak biçimlendirır.

Sözdizimi

Format-Wide
      [[-Property] <Object>]
      [-AutoSize]
      [-Column <int>]
      [-GroupBy <Object>]
      [-View <string>]
       [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>] 
      [<CommonParameters>]

Description

cmdlet'i Format-Wide nesneleri, her nesnenin yalnızca bir özelliğini görüntüleyen geniş bir tablo olarak biçimlendirmektedir. Hangi özelliğin görüntüleneceğini belirlemek için Property parametresini kullanabilirsiniz.

Örnekler

Örnek 1: Geçerli dizindeki dosyaların adlarını biçimlendirme

Bu komut, geçerli dizindeki dosyaların adlarını ekranda üç sütunda görüntüler.

Get-ChildItem | Format-Wide -Column 3

cmdlet'i Get-ChildItem dizindeki her dosyayı temsil eden nesneleri alır. İşlem hattı işleci (|), dosya nesnelerini çıkış için biçimlendiren işlem hattı üzerinden öğesine Format-Widegeçirir. Column parametresi sütun sayısını belirtir.

Örnek 2: Kayıt defteri anahtarlarının adlarını biçimlendirme

Bu komut, anahtardaki kayıt defteri anahtarlarının HKEY_CURRENT_USER\Software\Microsoft adlarını görüntüler.

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

cmdlet'i Get-ChildItem anahtarları temsil eden nesneleri alır. Yol, PowerShell Kayıt Defteri sağlayıcısı tarafından kullanıma sunulan sürücülerden biri ve ardından anahtar yolu olarak HKCU:belirtilir. İşlem hattı işleci (|), kayıt defteri anahtar nesnelerini çıkış için biçimlendiren işlem hattı üzerinden öğesine Format-Widegeçirir. Property parametresi özelliğin adını belirtir ve AutoSize parametresi sütunları okunabilirlik için ayarlar.

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

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

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


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

Parametreler

-AutoSize

Verilerin genişliğine göre sütun boyutunu ve sütun sayısını ayarlar. Varsayılan olarak, sütun boyutu ve sayısı görünüm tarafından belirlenir. OtomatikLeştir ve Sütun parametrelerini aynı komutta kullanamazsınız.

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

-Column

Görüntüdeki sütun sayısını belirtir. OtomatikLeştir ve Sütun parametrelerini aynı komutta kullanamazsınız.

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

-DisplayError

Komut satırında hataları görüntüler. Bu parametre nadiren kullanılır, ancak bir Format-Wide komuttaki 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

Koleksiyon nesnesini ve koleksiyondaki nesneleri biçimlendiriyor. Bu parametre System.Collections.ICollection arabirimini destekleyen nesneleri biçimlendirmek için tasarlanmıştır. Varsayılan değer şudur: EnumOnly.

Geçerli değerler:

  • 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:EnumOnly
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Bu cmdlet'in, değişikliklerin güvenliği tehlikeye atmaması için komutun başarılı olmasını engelleyen kısıtlamaları geçersiz kıldığını gösterir. Örneğin, Zorla bir dosya yolunu tamamlamak için salt okunur özniteliğini geçersiz kılar veya dizinler oluşturur, ancak dosya izinlerini değiştirmeye çalışmaz.

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

-GroupBy

Çıktıyı paylaşılan bir özelliğe veya değere göre gruplar halinde biçimlendirır. Çı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.

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

-InputObject

Biçimlendirecek 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 özelliğini 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:

  • Expression - <string> veya <script block>
  • FormatString - <string>

Daha fazla bilgi için bkz . about_Calculated_Properties.

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

-ShowError

İşlem hattı üzerinden hataları gönderir. Bu parametre nadiren kullanılır, ancak bir Format-Wide komuttaki 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 tablo biçiminin veya görünümünün adını belirtir. Özellik ve Görünüm parametrelerini aynı komutta 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, tabloyu temsil eden biçim nesnelerini döndürür.

Notlar

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

  • Tüm platformlar:
    • fw

GroupBy parametresi, nesnelerin sıralandığını varsayar. Kullanarak nesneleri gruplandırmadan önce Format-Custom 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ü tablo biçimini kullanmalıdır; kullanmazsa, komut başarısız olur. Alternatif görünüm bir listeyse kullanın Format-List. Alternatif görünüm liste veya tablo değilse kullanın Format-Custom.