Aracılığıyla paylaş

Format-Custom

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

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

Syntax

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

Description

cmdlet'i 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 veya yeni format.ps1xml bir dosyada kendi görünümlerinizi oluşturabilir ve cmdlet'ini Update-FormatData kullanarak bunları PowerShell'e ekleyebilirsiniz.

Ö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şlemiyle ilgili 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.

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-Custom 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. 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 İkisi: Koleksiyon nesnesinin özelliklerini ve koleksiyondaki nesneleri 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

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.

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:

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

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

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

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

Çıkışlar

Microsoft.PowerShell.Commands.Internal.Format

Format-Custom , görüntüyü temsil eden biçim nesnelerini döndürür.

Notlar

Format-Custom yalnızca tablo veya yalnızca liste olmayan görünümleri görüntülemek için tasarlanmıştır. Alternatif tablo görünümünü 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.

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

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