Bagikan melalui


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.

Output

ExtendedTypeDefinition