Get-FormatData
Geçerli oturumdaki biçimlendirme verilerini alır.
Sözdizimi
Default EnterprisePublishing
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
Description
Get-FormatData cmdlet'i geçerli oturumdaki biçimlendirme verilerini alır.
Oturumdaki biçimlendirme verileri, Format.ps1xml dizinindekiler gibi $PSHOME biçimlendirme dosyalarından verileri biçimlendirmeyi, oturuma aktardığınız modüllerin verilerini biçimlendirmeyi ve Import-PSSession cmdlet'ini kullanarak oturumunuza aktardığınız komutların verilerini biçimlendirmeyi içerir.
Biçimlendirme verilerini incelemek için bu cmdlet'i kullanabilirsiniz. Ardından, nesneleri serileştirmek, XML'ye dönüştürmek ve Export-FormatData dosyalarına kaydetmek için Format.ps1xml cmdlet'ini kullanabilirsiniz.
PowerShell'de dosyaları biçimlendirme hakkında daha fazla bilgi için bkz. about_Format.ps1xml.
Örnekler
Örnek 1: Tüm biçimlendirme verilerini alma
Bu örnek, oturumdaki tüm biçimlendirme verilerini alır.
Get-FormatData
Örnek 2: Tür adına göre biçimlendirme verilerini alma
Bu örnek, adları System.Management.Automation.Cmdile başlayan biçimlendirme veri öğelerini alır.
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
Örnek 3: Biçimlendirme veri nesnesini inceleme
Bu örnekte, bir biçimlendirme veri nesnesinin nasıl alınıp özelliklerini incelendiği gösterilmektedir.
$F = Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
$F
TypeName FormatViewDefinition
-------- --------------------
HelpInfoShort {help , TableControl}
$F.FormatViewDefinition[0].Control
Headers : {System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader}
Rows : {System.Management.Automation.TableControlRow}
AutoSize : False
HideTableHeaders : False
GroupBy :
OutOfBand : False
$F.FormatViewDefinition[0].Control.Headers
Label Alignment Width
----- --------- -----
CommandType Undefined 15
Name Undefined 50
Version Undefined 10
Source Undefined 0
Örnek 4: Biçimlendirme verilerini alma ve dışarı aktarma
Bu örnekte, modül tarafından eklenen biçimlendirme verilerini dışarı aktarmak için Get-FormatData ve Export-FormatData nasıl kullanılacağı gösterilmektedir.
$A = Get-FormatData
Import-Module BitsTransfer
$B = Get-FormatData
Compare-Object $A $B
InputObject SideIndicator
----------- -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>
Get-FormatData *bits* | Export-FormatData -FilePath C:\test\Bits.format.ps1xml
Get-Content C:\test\Bits.format.ps1xml
<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...
İlk dört komut, Get-FormatData modülünün oturuma eklediği biçim türünü tanımlamak için Import-Module, Compare-Objectve cmdlet'lerini kullanır.
Beşinci komut, Get-FormatData modülünün eklediği biçim türünü almak için cmdlet'ini kullanır. Biçim türü nesnesini | cmdlet'ine göndermek için bir işlem hattı işleci (Export-FormatData) kullanır ve bu da onu XML'e geri dönüştürür ve belirtilen Bits.format.ps1xml dosyasına kaydeder.
Son komut, format.ps1xml dosya içeriğinin bir alıntısını gösterir.
Örnek 5: Belirtilen PowerShell sürümüne göre biçimlendirme verilerini alma
Bu örnekte, belirtilen Get-FormatData ve PowerShell sürümüne ait biçim verilerini almak için nasıl kullanılacağı gösterilmektedir.
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
Parametreler
-PowerShellVersion
Biçimlendirme verileri için bu cmdlet'in aldığı PowerShell sürümünü belirtin. Noktayla ayrılmış iki basamaklı bir sayı girin.
Bu parametre, PowerShell'in eski sürümlerini çalıştıran bilgisayarlara uzaktan erişim sırasında uyumluluğu geliştirmek için PowerShell 5.1'e eklendi.
Parametre özellikleri
| Tür: | Version |
| 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 |
-TypeName
Bu cmdlet'in biçimlendirme verileri için aldığı tür adlarını belirtir. Tür adlarını girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| 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 |
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
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
