Biçimlendirme Verilerini Yükleme ve Dışa Aktarma

Biçimlendirme dosyanızı oluşturduktan sonra, dosyalarınızı geçerli oturuma yükleyerek oturumun biçim verilerini güncellemeniz gerekir. PowerShell önceden tanımlanmış bir format kümesini yükler. Geçerli oturumun biçim verileri güncelleştirildikten sonra PowerShell, yüklenen biçimlerde tanımlanan görünümlerle ilişkili .NET nesnelerini görüntülemek için bu verileri kullanır. Geçerli oturuma yükleyebileceğiniz format sayısında herhangi bir sınırlama yoktur. Ayrıca geçerli oturumdaki biçimlendirme verilerini bir biçimlendirme dosyasına geri aktarabilirsiniz.

Format verileri yükleniyor

Biçimlendirme dosyaları, aşağıdaki yöntemler kullanılarak geçerli oturuma yüklenebilir:

  • Biçimlendirme dosyasını geçerli oturuma komut satırından aktarabilirsiniz. Update-FormatData cmdlet'ini aşağıdaki prosedürde açıklandığı şekilde kullanın.

  • Biçimlendirme dosyanıza referans veren bir modül bildirimi oluşturabilirsiniz. Modüller, biçimlendirme dosyalarınızı dağıtım için paketlemenize olanak tanır. Bildirimi oluşturmak için New-ModuleManifest cmdlet'ini ve modülü geçerli oturuma yüklemek için Import-Module cmdlet'ini kullanın. Modüller hakkında daha fazla bilgi için bkz. Windows PowerShell Modülü Yazma.

  • Biçimlendirme dosyanıza başvuran bir ek bileşen oluşturabilirsiniz. Biçimlendirme dosyalarınıza başvurmak için System.Management.Automation.PSSnapIn.Formats öğesini kullanın. Ancak en iyi uygulama önerisi, cmdlet'leri ve ilgili biçimlendirme ve tür dosyalarını paketlemek için modüllerin kullanılmasıdır.

  • Komutları programlı olarak çağırıyorsanız, biçimlendirme dosyalarını komutların çalıştırıldığı çalışma alanının ilk oturum durumuna ekleyebilirsiniz. Daha fazla bilgi için System.Management.Automation.Runspaces.SessionStateFormatEntry sınıfına bakın.

Bir biçimlendirme dosyası yüklendiğinde, PowerShell'in ana bilgisayardaki nesneleri görüntülerken kullanılan görünümü seçmek için kullandığı dahili listeye eklenir. Biçimlendirme dosyanızı listenin başına ekleyebilir veya listenin sonuna ekleyebilirsiniz.

Biçimlendirme dosyanızın bu listeye nereye eklendiğini bilmek önemlidir.

  • Bir nesnenin tek görünümünü tanımlayan bir biçimlendirme dosyası yüklüyorsanız, daha önce açıklanan yöntemlerden herhangi birini kullanabilirsiniz.

  • Tanımlı mevcut bir görünüme sahip bir nesnenin görünümünü tanımlayan bir biçimlendirme dosyası yüklüyorsanız, listenin başına eklenmesi gerekir. Update-FormatData cmdlet'ini kullanmalı ve dosyanızı listenin başına eklemelisiniz.

Biçimlendirme Dosyanızı Saklama

Biçimlendirme dosyalarını diskin herhangi bir yerinde saklayabilirsiniz. Ancak bunları profil komut dosyanızla aynı klasörde saklamanız önerilir.

Profil komut dosyanızın konumunu belirlemek için aşağıdaki komutu kullanın.

Split-Path -Path $PROFILE -Parent

Format dosyası yükleniyor

  1. Biçimlendirme dosyanızı diske kaydedin.

  2. Aşağıdaki komutlardan birini kullanarak Update-FormatData cmdlet'ini çalıştırın.

    Bir nesnenin görüntülenme biçimini değiştiriyorsanız biçimlendirme dosyanızı listenin başına eklemek için aşağıdaki komutu kullanın.

    Update-FormatData -PrependPath PathToFormattingFile

    Biçimlendirme dosyanızı listenin sonuna eklemek için aşağıdaki komutu kullanın.

    Update-FormatData -AppendPath PathToFormattingFile

    Not

    Biçim verileri bir oturuma yüklendikten sonra kaldırılamaz. Format verileri yüklenmeden yeni bir oturum açmalısınız.

Biçim verilerini dışa aktarma

PowerShell birçok .NET türü için format tanımlarını içerir. Geçerli oturumda yüklenen biçim verilerini görüntülemek için Get-FormatData cmdlet'ini kullanabilirsiniz. Export-FormatData cmdlet'ini kullanarak bir türün format verilerini bir dosyaya aktarabilirsiniz.

Aşağıdaki komutlar, System.Guid türüne ilişkin biçim verilerini geçerli dizindeki System.Guid.format.ps1xml adlı bir dosyaya aktarır.

Get-FormatData System.Guid | Export-FormatData -Path ./System.Guid.format.ps1xml
Get-Content ./System.Guid.format.ps1xml

<?xml version="1.0" encoding="utf-8"?>
<Configuration>
  <ViewDefinitions>
    <View>
      <Name>System.Guid</Name>
      <ViewSelectedBy>
        <TypeName>System.Guid</TypeName>
      </ViewSelectedBy>
      <TableControl>
        <TableHeaders />
        <TableRowEntries>
          <TableRowEntry>
            <TableColumnItems>
              <TableColumnItem>
                <PropertyName>Guid</PropertyName>
              </TableColumnItem>
            </TableColumnItems>
          </TableRowEntry>
        </TableRowEntries>
      </TableControl>
    </View>
  </ViewDefinitions>
</Configuration>

Dışa aktarılan dosyayı düzenleyerek söz konusu tür için özel bir format tanımı oluşturabilirsiniz.

İlgili makaleler