Format-Custom
Çıktıyı biçimlendirmek için özelleştirilmiş bir görünüm kullanır.
Sözdizimi
Default EnterprisePublishing
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
Ö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.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String |
| Default value: | EnumOnly |
| Kabul edilen değerler: | CoreOnly, EnumOnly, Both |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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örüntülenir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 komut dosyası 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, about_Calculated_Propertiesbölümüne bakın.
Parametre özellikleri
| Tür: | Object |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InputObject
Biçimlendirilecek nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.
Parametre özellikleri
| Tür: | PSObject |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 komut dosyası 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, about_Calculated_Propertiesbölümüne bakın.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ShowError
Hataları işlem hattı yoluyla iletir. 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
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.
