Aracılığıyla paylaş

Update-FormatData

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

Geçerli oturumdaki biçimlendirme verilerini Güncelleştirmeler.

Syntax

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-FormatData Cmdlet, biçimlendirme verilerini biçimlendirme dosyalarından geçerli oturuma yeniden yükler. Bu cmdlet, PowerShell'i yeniden başlatmadan biçimlendirme verilerini güncelleştirmenizi sağlar.

Parametreler olmadan, Update-FormatData daha önce yüklemiş olduğu biçimlendirme dosyalarını yeniden yükler. oturuma yeni biçimlendirme dosyaları eklemek için parametresini Update-FormatData kullanabilirsiniz.

Biçimlendirme dosyaları, dosya adı uzantısına sahip XML biçimindeki format.ps1xml metin dosyalarıdır. Dosyalardaki biçimlendirme verileri, oturumdaki Microsoft .NET Framework nesnelerinin görüntülenmesini tanımlar.

PowerShell başlatıldığında, PowerShell kaynak kodundaki biçim verilerini yükler. Ancak, geçerli oturumdaki biçimlendirmeyi güncelleştirmek için özel format.ps1xml dosyaları oluşturabilirsiniz. PowerShell'i yeniden başlatmadan biçimlendirme verilerini geçerli oturuma yeniden yüklemek için kullanabilirsiniz Update-FormatData . Bu, bir biçimlendirme dosyası eklediğinizde veya değiştirdiğinizde, ancak oturumu kesintiye uğratmak istemediğinizde yararlıdır.

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

Örnekler

Örnek 1: Önceden yüklenmiş biçimlendirme dosyalarını yeniden yükleme

Update-FormatData

Bu komut, daha önce yüklemiş olduğu biçimlendirme dosyalarını yeniden yükler.

Örnek 2: Biçimlendirme dosyalarını yeniden yükleme ve biçimlendirme dosyalarını izleme ve günlüğe kaydetme

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

Bu komut, trace.format.ps1xml ve Log.format.ps1xml olmak üzere iki yeni dosya dahil olmak üzere biçimlendirme dosyalarını oturuma yeniden yükler.

Komutu AppendPath parametresini kullandığından, yeni dosyalardaki biçimlendirme verileri yerleşik dosyalardan gelen biçimlendirme verilerinden sonra yüklenir.

Yeni dosyalar yerleşik dosyalarda başvurulmayan nesneler için biçimlendirme verileri içerdiğinden AppendPath parametresi kullanılır.

Örnek 3: Biçimlendirme dosyasını düzenleme ve yeniden yükleme

Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

Bu örnekte, bir biçimlendirme dosyasını düzenledikten sonra nasıl yeniden yükleyebileceğiniz gösterilmektedir.

İlk komut, NewFiles.format.ps1xml dosyasını oturuma ekler. Dosya, yerleşik dosyalarda başvuruda bulunılan nesneler için biçimlendirme verileri içerdiğinden PrependPath parametresini kullanır.

NewFiles.format.ps1xml dosyasını ekleyip bu oturumlarda test ettikten sonra, yazar dosyayı düzenler.

İkinci komut, biçimlendirme dosyalarını yeniden yüklemek için cmdlet'ini kullanır Update-FormatData . NewFiles.format.ps1xml dosyası daha önce yüklendiğinden, Update-FormatData parametre kullanmadan otomatik olarak yeniden yükler.

Parametreler

-AppendPath

Bu cmdlet'in oturuma eklediği biçimlendirme dosyalarını belirtir. Dosyalar, PowerShell yerleşik biçimlendirme dosyalarını yükledikten sonra yüklenir.

.NET nesnelerini biçimlendirirken, PowerShell her .NET türü için bulduğu ilk biçimlendirme tanımını kullanır. AppendPath parametresini kullanırsanız PowerShell, eklediğiniz biçimlendirme verileriyle karşılaşmadan önce yerleşik dosyalardaki verileri arar.

Yerleşik biçimlendirme dosyalarında başvurulmayan bir .NET nesnesini biçimlendiren bir dosya eklemek için bu parametreyi kullanın.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrependPath

Bu cmdlet'in oturuma eklediği biçimlendirme dosyalarını belirtir. Dosyalar, PowerShell yerleşik biçimlendirme dosyalarını yüklemeden önce yüklenir.

.NET nesnelerini biçimlendirirken, PowerShell her .NET türü için bulduğu ilk biçimlendirme tanımını kullanır. PrependPath parametresini kullanırsanız PowerShell, yerleşik dosyalardan gelen biçimlendirme verileriyle karşılaşmadan önce eklediğiniz dosyalardan verileri arar.

Yerleşik biçimlendirme dosyalarında da başvuruda bulunılan bir .NET nesnesini biçimlendiren bir dosya eklemek için bu parametreyi kullanın.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

sonuna ekleme yolunu içeren bir dizeyi kanala Update-FormatDataaktarabilirsiniz.

Çıkışlar

None

Cmdlet herhangi bir çıkış döndürmez.

Notlar

  • Update-FormatData ayrıca modüllerden içeri aktarılan oturumdaki komutların biçimlendirme verilerini de güncelleştirir. Bir modülün biçimlendirme dosyası değişirse, içeri aktarılan komutların biçimlendirme verilerini güncelleştirmek için bir Update-FormatData komut çalıştırabilirsiniz. Modülü yeniden içeri aktarmanız gerekmez.