Get-FormatData

Mendapatkan data pemformatan dalam sesi saat ini.

Sintaks

Get-FormatData
   [[-TypeName] <String[]>]
   [-PowerShellVersion <Version>]
   [<CommonParameters>]

Deskripsi

Get-FormatData Cmdlet mendapatkan data pemformatan dalam sesi saat ini.

Data pemformatan dalam sesi mencakup pemformatan data dari Format.ps1xml pemformatan file, seperti yang ada $PSHOME di direktori, memformat data untuk modul yang Anda impor ke dalam sesi, dan memformat data untuk perintah yang Anda impor ke sesi Anda dengan menggunakan Import-PSSession cmdlet .

Anda dapat menggunakan cmdlet ini untuk memeriksa data pemformatan. Kemudian, Anda dapat menggunakan Export-FormatData cmdlet untuk membuat serialisasi objek, mengonversinya ke XML, dan menyimpannya dalam Format.ps1xml file.

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 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 Get-FormatDatacmdlet , Import-Module, dan Compare-Object untuk mengidentifikasi jenis format yang ditambahkan modul BitsTransfer ke sesi.

Perintah kelima menggunakan Get-FormatData cmdlet untuk mendapatkan jenis format yang ditambahkan modul BitsTransfer . Ini menggunakan operator alur (|) untuk mengirim objek jenis format ke Export-FormatData cmdlet, yang mengonversinya kembali ke XML dan menyimpannya dalam file yang ditentukan format.ps1xml .

Perintah akhir menunjukkan kutipan format.ps1xml konten file.

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.

Type:Version
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TypeName

Menentukan nama jenis yang didapat cmdlet ini untuk data pemformatan. Masukkan nama jenis. Kartubebas diizinkan.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Input

None

Anda tidak dapat menyalurkan input ke cmdlet ini.

Output

ExtendedTypeDefinition