Aracılığıyla paylaş

Get-FormatData

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Geçerli oturumdaki biçimlendirme verilerini alır.

Sözdizimi

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.

Tür:Version
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar