Aracılığıyla paylaş

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

Syntax

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 işlem hattı Format-Wideüzerinden öğesine geçirir ve bu nesneler çıkış için biçimlendirilir. 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 işlem hattı Format-Wideüzerinden öğesine geçirir ve bu nesneleri çıkış için biçimlendirır. 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. Otomatik Boyutlandırma ve Sütun parametrelerini aynı komutta kullanamazsınız.

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

-Column

Görüntüdeki sütun sayısını belirtir. Otomatik Boyutlandırma ve Sütun parametrelerini aynı komutta kullanamazsınız.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Expand

Koleksiyon nesnesini ve koleksiyondaki nesneleri biçimlendirin. Bu parametre, System.Collections.ICollection arabirimini destekleyen nesneleri biçimlendirmek için tasarlanmıştır. EnumOnly varsayılan değerdir.

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.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters: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 salt okunur özniteliğini geçersiz kılar veya bir dosya yolunu tamamlamak için dizinler oluşturur, ancak dosya izinlerini değiştirmeyi denemez.

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

-GroupBy

Çıkışı, 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.

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

-InputObject

Biçimlendirecek 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

Ekranda görünen 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. Parametre adı Özelliği 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.

Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

Girişler

PSObject

Herhangi bir nesneyi öğesine kanal oluşturabilirsiniz Format-Wide.

Çıkışlar

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide tabloyu temsil eden biçim nesnelerini döndürür.

Notlar

Ayrıca, yerleşik diğer adına fwda başvurabilirsinizFormat-Wide. Daha fazla bilgi için bkz. about_Aliases.

GroupBy parametresi, nesnelerin sıralandığını varsayar. Nesneleri gruplandırmak için kullanmadan Format-Custom önce 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 cmdlet'ini Update-FormatData kullanarak bunları PowerShell'e ekleyebilirsiniz.

View parametresinin alternatif görünümü tablo biçimini kullanmalıdır; aksi takdirde 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.