Format-Wide (Microsoft.PowerShell.Utility)

Format-Wide

Modül:: Microsoft.PowerShell.Utility

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

Sözdizimi

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

Tanım

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

Örnekler

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

Bu komut, geçerli dizindeki dosyaların adlarını ekran boyunca üç sütun halinde görüntüler.

Get-ChildItem | Format-Wide -Column 3

Get-ChildItem cmdlet'i dizindeki her dosyayı temsil eden nesneleri alır. İşlem hattı operatörü (|), dosya nesnelerini işlem hattı üzerinden çıktı için biçimlendiren Format-Wide'a geçirir. Sütun parametresi sütun sayısını belirtir.

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

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

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

Get-ChildItem cmdlet'i, 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 olan HKCU: olarak belirtilir ve ardından anahtar yolu gelir. İşlem hattı operatörü (|), kayıt defteri anahtarı nesnelerini işlem hattı üzerinden çıktı için biçimlendiren Format-Wide'a geçirir. Property parametresi özelliğin adını belirtir ve AutoSize parametresi sütunları okunabilirlik açısından ayarlar.

Örnek 3: Biçim hatalarında sorun giderme

Aşağıdaki örneklerde DisplayError veya ShowError parametrelerinin bir ifadeyle eklenmesinin 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üme göre belirlenir. Otomatik Boyutlandırma ve Sütun parametrelerini aynı komutta kullanamazsınız.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Column

Ekrandaki sütun sayısını belirtir. Otomatik Boyutlandırma ve Sütun parametrelerini aynı komutta kullanamazsınız.

Tip :: Int32
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-DisplayError

Komut satırındaki hataları görüntüler. Bu parametre nadiren kullanılır, ancak ifadeleri Format-Wide komutunda biçimlendirirken ve ifadeler çalışıyor gibi görünmediğinde hata ayıklamaya yardımcı olarak kullanılabilir.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Expand

Koleksiyon nesnesinin yanı sıra koleksiyondaki nesneleri de formatlar. Bu parametre, System.Collections.ICollection arayüzünü destekleyen nesneleri biçimlendirmek için tasarlanmıştır. Varsayılan değer EnumOnly'dır.

Geçerli değerler şunlardır:

EnumOnly: Koleksiyondaki nesnelerin özelliklerini görüntüler.
CoreOnly: Koleksiyon nesnesinin özelliklerini görüntüler.
Her İkisi: Koleksiyon nesnesinin özelliklerini ve koleksiyondaki nesnelerin özelliklerini görüntüler.

Tip :: String
Kabul edilen değerler:: Yalnızca Core, EnumOnly, Her İkisi
Konum:: Adlandırılmış
Varsayılan değer:: EnumOnly
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Force

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

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-GroupBy

Çıktıyı, paylaşılan bir özelliğe veya değere göre gruplar halinde biçimlendirir. Çıktının bir ifadesini veya özelliğini girin.

GroupBy parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir kod bloğu veya karma tablosu olabilir. Geçerli anahtar/değer çiftleri şunlardır:

Ad (veya Etiket) - <string>
İfade - <string> veya <script; bloğu>
FormatString - <string>

Daha fazla bilgi için bkz. about_Calculated_Properties.

Tip :: Nesne
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: 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.

Tip :: PSObject
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: 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. Özellik parametre adı isteğe bağlıdır. Özellik ve Görünüm parametrelerini aynı komutta kullanamazsınız.

Özellik parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir kod bloğu veya karma tablosu olabilir. Geçerli anahtar/değer çiftleri şunlardır:

İfade - <string> veya <script; bloğu>
FormatString - <string>

Daha fazla bilgi için bkz. about_Calculated_Properties.

Tip :: Nesne
Konum:: 0
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: True

-ShowError

Hataları ardışık düzen üzerinden gönderir. Bu parametre nadiren kullanılır, ancak ifadeleri Format-Wide komutunda biçimlendirirken ve ifadeler çalışıyor gibi görünmediğinde hata ayıklamaya yardımcı olarak kullanılabilir.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-View

Alternatif tablo formatının veya görünümünün adını belirtir. Özellik ve Görünüm parametrelerini aynı komutta kullanamazsınız.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

PSObject

Bu cmdlet'e herhangi bir nesneyi aktarabilirsiniz.

Çıkışlar

Microsoft.PowerShell.Commands.Internal.Format

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

Notlar

PowerShell, Format-Wide için aşağıdaki takma adları içerir:

Tüm platformlar:

GroupBy parametresi nesnelerin sıralandığını varsayar. Nesneleri gruplamak için Format-Custom'u kullanmadan önce Sort-Object'i kullanın.

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 Update-FormatData cmdlet'ini kullanabilirsiniz. bunları PowerShell'e dahil etmek için.

Görünüm parametresinin alternatif görünümü tablo biçimini kullanmalıdır; eğer değilse, komut başarısız olur. Alternatif görünüm bir liste ise Format-List'i kullanın. Alternatif görünüm bir liste veya tablo değilse Format-Custom'u kullanın.