Export-FormatData

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

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

Syntax

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 nesnelerin varsayılan görünümünü oluşturmak için verileri biçimlendirme dosyalarında (format.ps1xml) 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.

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

komut, biçim verilerini komuttan Get-FormatData cmdlet'e göndermek için Export-FormatData 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ünün 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 Export-FormatDataInputObject parametresini $F kullanır. Ayrıca çıkışa 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'in 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 bu da 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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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ği için varsayılan olarak dışarı aktarılmaz.

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

-InputObject

Dışarı aktarılacak veri nesnelerini biçimlendirmeyi belirtir. Nesneleri içeren bir değişken veya nesneleri alan komut gibi bir Get-FormatData komut girin. Ayrıca içindeki nesneleri öğesine Get-FormatDataExport-FormatDatade yöneltebilirsiniz.

Type:ExtendedTypeDefinition[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

Cmdlet'in varolan 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.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

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

Type:String
Aliases:FilePath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.