Aracılığıyla paylaş

Update-FormatData

Modül:
Microsoft.PowerShell.Utility Module

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

Sözdizimi

Default EnterprisePublishing 

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

Description

Update-FormatData cmdlet'i, 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 Update-FormatData parametrelerini kullanabilirsiniz.

Biçimlendirme dosyaları, format.ps1xml dosya adı uzantısıyla XML biçimindeki 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 Update-FormatData kullanabilirsiniz. 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, Trace.format.ps1xml ve Log.format.ps1xmlolmak üzere iki yeni dosya da dahil olmak üzere biçimlendirme dosyalarını oturuma yeniden yükler.

Komut AppendPath parametresini kullandığından, yerleşik dosyalardan biçimlendirme verileri yüklendikten sonra yeni dosyalardaki biçimlendirme verileri 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 Update-FormatData cmdlet'ini kullanır. 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.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:PSPath, Yol

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

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

-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.

Parametre özellikleri

Tür:

String[]

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

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

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

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

String

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

Çıkışlar

None

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

Notlar

  • Update-FormatData, 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 komutu çalıştırabilirsiniz. Modülü yeniden içeri aktarmanız gerekmez.