Format-Wide
Nesneleri, her nesnenin yalnızca bir özelliğini görüntüleyen geniş bir tablo olarak biçimlendirır.
Syntax
Default (Varsayılan)
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Description
Format-Wide cmdlet'i nesneleri, her nesnenin yalnızca bir özelliğini görüntüleyen geniş bir tablo olarak biçimlendirmektedir. Hangi özelliğin görüntüleneceğini belirlemek için Özelliği parametresini kullanabilirsiniz.
Örnekler
Örnek 1: Geçerli dizindeki dosyaların adlarını biçimlendirme
Bu komut, geçerli dizindeki dosyaların adlarını ekranda üç sütunda görüntüler.
Get-ChildItem | Format-Wide -Column 3
Get-ChildItem cmdleti, dizindeki her dosyayı temsil eden nesneleri elde eder. İşlem hattı işleci (|), dosya nesnelerini çıkış için biçimlendiren Format-Wide'a işlem hattı üzerinden geçirir.
Sütun parametresi sütun sayısını belirtir.
Örnek 2: Kayıt defteri anahtarlarının adlarını biçimlendirme
Bu komut, HKEY_CURRENT_USER\Software\Microsoft anahtarında kayıt defteri anahtarlarının adlarını görüntüler.
Get-ChildItem HKCU:\software\Microsoft | Format-Wide -Property PSChildName -AutoSize
Get-ChildItem cmdlet, anahtarları temsil eden nesneleri getirir. Yol, PowerShell Kayıt Defteri sağlayıcısı tarafından kullanıma sunulan sürücülerden biri olan HKCU:ve ardından da anahtar yolu olarak belirtilir. İşlem hattı işleci (|), kayıt defteri anahtar nesnelerini işlem hattı üzerinden Format-Widegeçirir ve bu da bunları çıkış için biçimlendirır.
Özelliği parametresi özelliğin adını belirtir ve AutoSize parametresi sütunları okunabilirlik için ayarlar.
Örnek 3: Biçim hatalarını giderme
Aşağıdaki örneklerde, bir ifadeyle DisplayError veya ShowError parametrelerini eklemenin sonuçları gösterilmektedir.
PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError
#ERR
PS /> Get-Date | Format-Wide { $_ / $null } -ShowError
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError
Parametreler
-AutoSize
Verilerin genişliğine göre sütun boyutunu ve sütun sayısını ayarlar. Varsayılan olarak, sütun boyutu ve sayısı görünüm tarafından belirlenir. Otomatik Boyutlandırma ve Sütun parametrelerini aynı komutta kullanamazsınız.
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 |
-Column
Görüntüdeki sütun sayısını belirtir. Otomatik Boyutlandırma ve Sütun parametrelerini aynı komutta kullanamazsınız.
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-Wide 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 şudur: EnumOnly.
Geçerli değerler şunlardır:
-
EnumOnly: Koleksiyondaki nesnelerin özelliklerini görüntüler. -
CoreOnly: Koleksiyon nesnesinin özelliklerini görüntüler. -
Both: Koleksiyon nesnesinin özelliklerini ve koleksiyondaki nesnelerin özelliklerini 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
Bu cmdlet'in, değişikliklerin güvenliği tehlikeye atmaması için komutun başarılı olmasını engelleyen kısıtlamaları geçersiz kıldığını gösterir. Örneğin, Force komutu, salt okunur özniteliğini geçersiz kılacak veya bir dosya yolunu tamamlamak için dizinler oluşturacak, ancak dosya izinlerini değiştirmeye çalışmayacaktı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 |
-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-Wide 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:
-
Name(veyaLabel) -<string> -
Expression-<string>veya<scriptblock> 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çimlendirecek 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 özelliğini 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:
-
Expression-<string>veya<scriptblock> 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: | 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-Wide 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 tablo biçiminin veya görünümünün adını belirtir. 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, tabloyu temsil eden biçim nesnelerini döndürür.
Notlar
PowerShell, Format-Wideiçin aşağıdaki diğer adları içerir:
- Tüm platformlar:
fw
Görünüm parametresi, tablo için alternatif bir biçim belirtmenize olanak tanır. PowerShell dizinindeki *.format.ps1xml dosyalarında tanımlanan görünümleri kullanabilir veya yeni PS1XML dosyalarında kendi görünümlerinizi oluşturabilir ve bunları PowerShell'e eklemek için Update-FormatData cmdlet'ini kullanabilirsiniz.
Görünüm parametresinin alternatif görünümü tablo biçimini kullanmalıdır; aksi takdirde komut başarısız olur. Alternatif görünüm bir listeyse Format-Listkullanın. Alternatif görünüm liste veya tablo değilse Format-Customkullanın.
