Aracılığıyla paylaş

Format-Custom

  • Başvuru
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>]

Description

Cmdlet, Format-Custom bir komutun çıkışını alternatif bir görünümde tanımlandığı şekilde biçimlendirır. Format-Custom yalnızca tablo veya yalnızca 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 format.ps1xml bir dosyada kendi görünümlerinizi oluşturabilir ve bunları PowerShell'e eklemek için cmdlet'ini kullanabilirsiniz Update-FormatData .

Örnekler

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

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

Bu komut, cmdlet'i hakkındaki Start-Transcript 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çimlendirilir. Bu komutu başarıyla çalıştırmak için önce yeni bir PS1XML dosyası oluşturmanız, MyView görünümünü tanımlamanız ve ardından komutunu kullanarak Update-FormatData PS1XML dosyasını PowerShell'e eklemeniz gerekir.

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

Get-Process Winlogon | Format-Custom

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

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

Aşağıdaki örneklerde, bir ifadeyle DisplayError veya ShowError parametrelerini eklemenin 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

Görüntüdeki sütun sayısını belirtir.

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-Custom 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 EnumOnly'dir.

Geçerli değerler:

  • EnumOnly: Koleksiyondaki nesnelerin özelliklerini görüntüler.
  • CoreOnly: Koleksiyon nesnesinin özelliklerini görüntüler.
  • Her ikisi: Koleksiyon nesnesinin özelliklerini ve koleksiyondaki nesneleri 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

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

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:

  • Ad (veya Etiket) - <string>
  • İfade - <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çimlendirilecek 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 ö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. Ö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:

  • İfade - <string> veya <script block>
  • Derinlik- <int32>

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

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, görüntüyü temsil eden biçim nesnelerini döndürür.

Notlar

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

  • Tüm platformlar:
    • fc

Format-Custom yalnızca tablo veya yalnızca 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 kullanın Format-Table. Alternatif liste görünümünü görüntülemek için kullanın Format-List.

GroupBy parametresi, nesnelerin sıralandığını varsayar. Format-Custom Kullanarak nesneleri gruplandırmadan önce, bunları sıralamak için kullanınSort-Object.