Format-Custom (Microsoft.PowerShell.Utility)

Format-Custom

Modül:: Microsoft.PowerShell.Utility

Çıktıyı biçimlendirmek için özelleştirilmiş bir görünüm kullanır.

Sözdizimi

Format-Custom
      [[-Property] <Object[]>]
      [-Depth <Int32>]
      [-GroupBy <Object>]
      [-View <String>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <String>]
      [-InputObject <PSObject>]
      [<CommonParameters>]

Tanım

Format-Custom cmdlet'i, bir komutun çıktısını alternatif görünümde tanımlandığı şekilde biçimlendirir. Format-Custom yalnızca tablo veya liste olmayan görünümleri görüntülemek için tasarlanmıştır. PowerShell'de tanımlanan görünümleri kullanabilir veya yeni bir format.ps1xml dosyasında kendi görünümlerinizi oluşturabilir ve bunları PowerShell'e eklemek için Update-FormatData cmdlet'ini kullanabilirsiniz.

Örnekler

Örnek 1: Çıktıyı özel görünümle biçimlendirme

Get-Command Start-Transcript | Format-Custom -View MyView

Bu komut, Start-Transcript cmdlet'i hakkındaki bilgileri, kullanıcı tarafından oluşturulan özel bir görünüm olan MyView görünümü tarafından tanımlanan biçimde biçimlendirir. Bu komutu başarıyla çalıştırmak için önce yeni bir PS1XML dosyası oluşturmalı, MyView görünümünü tanımlamalı ve ardından PS1XML dosyasını PowerShell'e eklemek için Update-FormatData komutunu kullanmalısınız.

Örnek 2: Çıktıyı varsayılan görünümle biçimlendirme

Get-Process Winlogon | Format-Custom

Bu komut, Winlogon işlemiyle ilgili bilgileri alternatif bir özelleştirilmiş görünümde biçimlendirir. Komut, Görünüm parametresini kullanmadığından, Format-Custom, verileri biçimlendirmek için varsayılan bir özel görünüm kullanır.

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

Aşağıdaki örneklerde DisplayError veya ShowError parametrelerinin bir ifadeyle eklenmesinin sonuçları gösterilmektedir.

PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -DisplayError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}


PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -ShowError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

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

Parametreler

-Depth

Ekrandaki sütun sayısını belirtir.

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-Custom komutunda biçimlendirirken ve ifadeler çalışmıyor gibi göründüğünde 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'dir.

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

Tüm hata bilgilerini görüntülemek için cmdlet'i yönlendirir. DisplayError veya ShowError parametreleriyle kullanın. Varsayılan olarak, hata veya görüntü akışlarına bir hata nesnesi yazıldığında, hata bilgilerinin yalnızca bir kısmı görüntülenir.

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 özelliklerini ve bunların görünme 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. Ö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>
Derinlik - <int32>

Daha fazla bilgi için bkz. about_Calculated_Properties.

Tip :: Object[]
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-Custom komutunda biçimlendirirken ve ifadeler çalışmıyor gibi göründüğünde 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 biçimin veya görünümün adını belirtir. Bu parametreyi atlarsanız Format-Custom varsayılan özel görünümü kullanır. Ö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, ekranı temsil eden biçim nesnelerini döndürür.

Notlar

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

Tüm platformlar:

Format-Custom yalnızca tablo veya liste olmayan görünümleri görüntülemek için tasarlanmıştır. Alternatif bir tablo görünümü görüntülemek için Format-Table'ı kullanın. Alternatif bir liste görünümü görüntülemek için Format-List'i kullanın.

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