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.

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 Get-FormatDataExtendedTypeDefinition nesnelerini 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 Update-FormatData cmdlet'ini kullanarak biçimlendirme verilerini bir oturuma ekleyebilirsiniz.

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 parametresi için (tümü) değeri * , cmdlet'i oturumdaki tüm verileri almaya yönlendirir.

Komut, komuttan Get-FormatData cmdlet'ine biçim verilerini 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 bunu değişkene $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'e Export-FormatData göndermek için bir işlem hattı işleci (|) kullanır ve bu da verileri 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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:ExtendedTypeDefinition[]
Position:Named
Default value:None
Required:True
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
Required:True
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 uyarı vermeden dosyaların üzerine yazar.

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

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

Girişler

ExtendedTypeDefinition

ExtendedTypeDefinition nesnelerini içinden Get-FormatData öğesine yöneltebilirsinizExport-FormatData.

Çıkışlar

None

Export-FormatData hiçbir nesne 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.