Export-FormatData
Geçerli oturumdaki biçimlendirme verilerini bir biçimlendirme dosyasına kaydeder.
Sözdizimi
ByPath EnterprisePublishing
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-Path <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
ByLiteralPath
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-LiteralPath <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
Description
Export-FormatData cmdlet'i geçerli oturumdaki biçimlendirme nesnelerinden PowerShell biçimlendirme dosyaları (format.ps1xml) oluşturur.
döndüren Get-FormatData 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 dosyaları biçimlendirme (format.ps1xml) içindeki 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 biçim verilerini almak için Get-FormatData cmdlet'ini kullanır.
* parametresi için (tümü) değeri, cmdlet'i oturumdaki tüm verileri almaya yönlendirir.
Komut, biçim verilerini | dosyasına aktaran Get-FormatData cmdlet'ine Export-FormatData komutundan biçim verilerini göndermek için bir işlem hattı işleci (AllFormat.ps1xml) kullanır.
Export-FormatData komutu, 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, Get-FormatData türünün biçim verilerini almak için cmdlet'ini kullanır ve $F değişkenine kaydeder.
İkinci komut, değişkenine kaydedilen biçim verilerini girmek için Export-FormatData cmdlet'in $F parametresini 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 komutundan Export-FormatData parametresini atlamanın etkisi gösterilmektedir.
İlk komut, Get-Process cmdlet'in döndürdüğü Get-FormatData nesnesinin biçim verilerini almak için cmdlet'ini kullanır. Komut, biçimlendirme verilerini geçerli dizindeki | dosyasına aktaran Export-FormatData cmdlet'ine göndermek için bir işlem hattı işleci (Process.format.ps1xml) kullanır.
Bu durumda, Export-FormatData komutu IncludeScriptBlock parametresini kullanmaz.
İkinci komut, Update-FormatData dosyasını geçerli oturuma eklemek için Process.format.ps1xml cmdlet'ini kullanır. Komutu, process nesneleri için standart biçimlendirme verisi öncesinde Process.format.ps1xml dosyasındaki işlem nesneleri için biçimlendirme verilerinin 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 Get-Process cmdlet'ini kullanır. Çı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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InputObject
Dışarı aktarılacak veri nesnelerinin biçimini belirtir. Nesneleri içeren bir değişken veya Get-FormatData komutu gibi nesneleri alan bir komut girin. Nesneleri Get-FormatData'den Export-FormatData'e de yöneltebilirsiniz.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
ByLiteralPath
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-NoClobber
Cmdlet'in var olan dosyaların üzerine yazmadığını gösterir. Varsayılan olarak, Export-FormatData dosya salt okunur niteliğine sahip olmadığı sürece uyarı vermeden dosyaların üzerine yazılır.
Export-FormatData salt okunur dosyaların üzerine yazmaya yönlendirmek için Zorlama parametresini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | NoOverwrite |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Çıkış dosyası için bir konum belirtir.
format.ps1xml dosya adı uzantısıyla bir yol (isteğe bağlı) ve dosya adı girin. Yolu atlarsanız, Export-FormatData dosyayı geçerli dizinde oluşturur.
.ps1xmldışında bir dosya adı uzantısı kullanırsanız, Update-FormatData cmdlet dosyayı tanımaz.
Var olan bir dosyayı belirtirseniz, Export-FormatData dosyanın salt okunur özniteliğine sahip olmadığı sürece uyarı vermeden dosyanın üzerine yazar. Salt okunur bir dosyanın üzerine yazmak için Zorlama parametresini kullanın. Dosyaların üzerine yazılmasını önlemek için NoClobber
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | FilePath |
Parametre kümeleri
ByPath
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
ExtendedTypeDefinition
'den Get-FormatData nesnelerini bu cmdlet'e 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.
