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

Format-Custom cmdlet'i, bir komutun çıktısını alternatif bir görünümde tanımlandığı şekilde biçimlendirir. 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 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: Çıkışı ö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ç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 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 Görünüm 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 komutunda 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 EnumOnlydeğeridir.

Geçerli değerler şunlardır:

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, bir hata nesnesi hata veya görüntü akışlarına yazıldığında, hata bilgilerinin yalnızca bir kısmı gösterilir.

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 parametresi nesnelerin sıralanmasını bekler. Nesneleri gruplandırmak için Sort-Object kullanmadan önce Format-Custom cmdlet'ini kullanın.

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. Parametre adı , Özellik isteğe bağlıdır. Aynı komutta Özelliği ve Görünüm parametrelerini kullanamazsınız.

Özelliği 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 komutunda 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 bir özel görünüm kullanır. Aynı komutta Özelliği ve Görünüm parametrelerini 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, Format-Customiçin aşağıdaki diğer adları iç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 Format-Tablekullanın. Alternatif liste görünümünü görüntülemek için Format-Listkullanın.

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

Aracılığıyla paylaş