Get-FormatData
Mendapatkan data pemformatan dalam sesi saat ini.
Sintaks
Default (Default)
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
Deskripsi
cmdlet Get-FormatData mendapatkan data pemformatan dalam sesi saat ini.
Data pemformatan dalam sesi mencakup pemformatan data dari file pemformatan Format.ps1xml, seperti yang ada di direktori $PSHOME, memformat data untuk modul yang Anda impor ke dalam sesi, dan memformat data untuk perintah yang Anda impor ke sesi Anda dengan menggunakan cmdlet Import-PSSession.
Anda dapat menggunakan cmdlet ini untuk memeriksa data pemformatan. Kemudian, Anda dapat menggunakan cmdlet Export-FormatData untuk membuat serialisasi objek, mengonversinya ke XML, dan menyimpannya dalam file Format.ps1xml.
Untuk informasi selengkapnya tentang memformat file di PowerShell, lihat about_Format.ps1xml.
Contoh
Contoh 1: Mendapatkan semua data pemformatan
Contoh ini mendapatkan semua data pemformatan dalam sesi.
Get-FormatData
Contoh 2: Mendapatkan data pemformatan menurut nama jenis
Contoh ini mendapatkan item data pemformatan yang namanya dimulai dengan System.Management.Automation.Cmd.
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
Contoh 3: Memeriksa objek data pemformatan
Contoh ini memperlihatkan cara mendapatkan objek data pemformatan dan memeriksa propertinya.
$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
Contoh 4: Mendapatkan data pemformatan dan mengekspornya
Contoh ini menunjukkan cara menggunakan Get-FormatData dan Export-FormatData untuk mengekspor data pemformatan yang ditambahkan oleh modul.
$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>
...
Empat perintah pertama menggunakan cmdlet Get-FormatData, Import-Module, dan Compare-Object untuk mengidentifikasi jenis format yang ditambahkan modul BitsTransfer ke sesi.
Perintah kelima menggunakan cmdlet Get-FormatData untuk mendapatkan jenis format yang ditambahkan modul BitsTransfer. Ini menggunakan operator alur (|) untuk mengirim objek jenis format ke cmdlet Export-FormatData, yang mengonversinya kembali ke XML dan menyimpannya dalam file Bits.format.ps1xml yang ditentukan.
Perintah akhir menunjukkan kutipan konten file format.ps1xml.
Contoh 5: Mendapatkan data pemformatan berdasarkan versi PowerShell yang ditentukan
Contoh ini memperlihatkan cara menggunakan Get-FormatData untuk mendapatkan data format untuk TypeName dan versi PowerShell tertentu.
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
Parameter
-PowerShellVersion
Tentukan versi PowerShell yang didapat cmdlet ini untuk data pemformatan. Masukkan dua digit angka yang dipisahkan oleh titik.
Parameter ini ditambahkan di PowerShell 5.1 untuk meningkatkan kompatibilitas saat jarak jauh ke komputer yang menjalankan versi PowerShell yang lebih lama.
Properti parameter
| Jenis: | Version |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-TypeName
Menentukan nama tipe yang didapat cmdlet ini untuk data pemformatan. Masukkan nama jenis. Kartu liar diizinkan.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
