Aracılığıyla paylaş

Export-FormatData

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

Geçerli oturumdaki biçimlendirme verilerini bir biçimlendirme dosyasına kaydeder.

Sözdizimi

Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -Path <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]
Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -LiteralPath <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]

Description

Cmdlet, Export-FormatData geçerli oturumdaki biçimlendirme nesnelerinden PowerShell biçimlendirme dosyaları (format.ps1xml) oluşturur. Döndüren ExtendedTypeDefinition nesnelerini Get-FormatData alır ve bunları XML biçiminde bir dosyaya kaydeder.

PowerShell, oturumdaki Microsoft .NET Framework nesnelerinin varsayılan görüntüsünü oluşturmak için biçimlendirme dosyalarındaki (format.ps1xml) verileri kullanır. Biçimlendirme dosyalarını görüntüleyebilir ve düzenleyebilir ve biçimlendirme verilerini bir oturuma eklemek için Update-FormatData cmdlet'ini kullanabilirsiniz.

PowerShell'de dosyaları biçimlendirme hakkında daha fazla bilgi için bkz . about_Format.ps1xml.

Örnekler

Örnek 1: Oturum biçimi verilerini dışarı aktarma

Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

Bu komut oturumdaki tüm biçim verilerini AllFormat.ps1xml dosyasına aktarır.

komutu, oturumdaki Get-FormatData biçim verilerini almak için cmdlet'ini kullanır. TypeName parametresi için (tümü) değeri * , cmdlet'i oturumdaki tüm verileri almaya yönlendirir.

Komut, komuttan Get-FormatData Export-FormatData cmdlet'e biçim verilerini göndermek için bir işlem hattı işleci (|) kullanır ve bu da biçim verilerini AllFormat.ps1 dosyasına aktarır.

Komut, Export-FormatData dosyadaki biçim verilerine betik blokları eklemek için IncludeScriptBlock parametresini kullanır.

Örnek 2: Bir tür için biçim verilerini dışarı aktarma

$F = Get-FormatData -TypeName "helpinfoshort"
Export-FormatData -InputObject $F -Path "c:\test\help.format.ps1xml" -IncludeScriptBlock

Bu komutlar HelpInfoShort türü için biçim verilerini Help.format.ps1xml dosyasına aktarır.

İlk komut, HelpInfoShort türünün biçim verilerini almak için cmdlet'ini kullanır Get-FormatData ve değişkenine $F kaydeder.

İkinci komut, değişkene kaydedilen biçim verilerini girmek için cmdlet'in InputObject parametresini Export-FormatData $F kullanır. Ayrıca çıktıya betik blokları eklemek için IncludeScriptBlock parametresini kullanır.

Örnek 3: Betik bloğu olmadan biçim verilerini dışarı aktarma

Get-FormatData -TypeName "System.Diagnostics.Process" | Export-FormatData -Path process.format.ps1xml
Update-FormatData -PrependPath ".\process.format.ps1xml"
Get-Process p*

Handles  NPM(K)  PM(K)  WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------  -----  ----- -----   ------    -- -----------
323                                       5600 powershell
336                                       3900 powershell_ise
138                                       4076 PresentationFontCache

Bu örnekte, bir Export-FormatData komuttan IncludeScriptBlock parametresini atlamanın etkisi gösterilmektedir.

İlk komut, Get-Process cmdlet'inin döndürdüğü System.Diagnostics.Process nesnesinin biçim verilerini almak için cmdlet'ini kullanırGet-FormatData. Komut, biçimlendirme verilerini cmdlet'ine Export-FormatData göndermek için bir işlem hattı işleci (|) kullanır ve bunu geçerli dizindeki Process.format.ps1xml dosyasına aktarır.

Bu durumda, Export-FormatData komut IncludeScriptBlock parametresini kullanmaz.

İkinci komut, geçerli oturuma Process.format.ps1xml dosyasını eklemek için cmdlet'ini kullanır Update-FormatData . Komutu, Process.format.ps1xml dosyasındaki işlem nesneleri için biçimlendirme verilerinin, işlem nesneleri için standart biçimlendirme verisi öncesinde bulunduğundan emin olmak için PrependPath parametresini kullanır.

Üçüncü komut bu değişikliğin etkilerini gösterir. komutu, P ile başlayan adlara sahip işlemleri almak için cmdlet'ini kullanır Get-Process . Çıktı, betik blokları kullanılarak hesaplanan özellik değerlerinin görüntüde eksik olduğunu gösterir.

Parametreler

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IncludeScriptBlock

Biçim verilerindeki betik bloklarının dışarı aktarılıp aktarılmadığını gösterir.

Betik blokları kod içerdiği ve kötü amaçlı olarak kullanılabildiğinden, bunlar varsayılan olarak dışarı aktarılmaz.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InputObject

Dışarı aktarılacak veri nesnelerinin biçimini belirtir. Nesneleri içeren bir değişken veya komut gibi nesneleri alan bir Get-FormatData komut girin. Nesneleri 'den Get-FormatData öğesine Export-FormatDatade yöneltebilirsiniz.

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

-LiteralPath

Çıkış dosyası için bir konum belirtir. Path parametresinden farklı olarak, LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Tür:String
Diğer adlar:PSPath, LP
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-NoClobber

Cmdlet'in var olan dosyaların üzerine yazmadığını gösterir. Varsayılan olarak, Export-FormatData dosya salt okunur özniteliğine sahip olmadığı sürece dosyaların üzerine uyarı vermeden yazar.

Salt okunur dosyaların üzerine yazmaya yönlendirmek Export-FormatData için Zorla parametresini kullanın.

Tür:SwitchParameter
Diğer adlar:NoOverwrite
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Path

Çıkış dosyası için bir konum belirtir. format.ps1xml dosya adı uzantısına sahip bir yol (isteğe bağlı) ve dosya adı girin. Yolu atlarsanız, Export-FormatData dosyayı geçerli dizinde oluşturur.

.ps1xml dışında bir dosya adı uzantısı kullanırsanız, Update-FormatData cmdlet dosyayı tanımaz.

Mevcut bir dosya belirtirseniz, Export-FormatData dosyanın salt okunur özniteliği olmadığı sürece, uyarı vermeden dosyanın üzerine yazar. Salt okunur bir dosyanın üzerine yazmak için Zorla parametresini kullanın. Dosyaların üzerine yazılmasını önlemek için NoClobber parametresini kullanın.

Tür:String
Diğer adlar:FilePath
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

ExtendedTypeDefinition

ExtendedTypeDefinition nesnelerini bu cmdlet'e Get-FormatData yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez. Bir dosya oluşturur ve belirtilen yola kaydeder.

Notlar

  • Dışarı aktarılan biçimlendirme dosyası da dahil olmak üzere herhangi bir biçimlendirme dosyasını kullanmak için, oturumun yürütme ilkesi betiklerin ve yapılandırma dosyalarının çalışmasına izin vermelidir. Daha fazla bilgi için bkz. about_Execution_Policies.