Get-FormatData
Mendapatkan data pemformatan dalam sesi saat ini.
Sintaks
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 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 remoting komputer yang menjalankan versi PowerShell yang lebih lama.
Jenis: | Version |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TypeName
Menentukan nama tipe yang didapat cmdlet ini untuk data pemformatan. Masukkan nama jenis. Kartubebas diizinkan.
Jenis: | String[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | True |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.