Aracılığıyla paylaş

Update-FormatData

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

Geçerli oturumdaki biçimlendirme verilerini güncelleştirir.

Sözdizimi

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

Description

Update-FormatData Cmdlet, biçimlendirme dosyalarının biçimlendirme verilerini 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ıyla 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şladığında, PowerShell kaynak kodundan 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ı ve izleme ve günlük biçimlendirme dosyalarını yeniden yükleme

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

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

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

AppendPath parametresi, yeni dosyalar yerleşik dosyalarda başvurulmayan nesneler için biçimlendirme verileri içerdiğinden 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ı ekledikten ve 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. PowerShell yerleşik biçimlendirme dosyalarını yükledikten sonra dosyalar yüklenir.

PowerShell, .NET nesnelerini biçimlendirirken 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.

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

-Confirm

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

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

-PrependPath

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

PowerShell, .NET nesnelerini biçimlendirirken 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.

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

-WhatIf

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

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

Girişler

String

Bu cmdlet'in ekleme yolunu içeren bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

  • Update-FormatData ayrıca modüllerden içeri aktarılan oturumdaki komutlar için biçimlendirme verilerini 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.