Güncelleme TürüVerileri (Microsoft.PowerShell.Utility)

Update-TypeData

Modül:: Microsoft.PowerShell.Utility

Oturumdaki genişletilmiş tür verilerini günceller.

Sözdizimi

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

Update-TypeData
      [-MemberType <PSMemberTypes>]
      [-MemberName <String>]
      [-Value <Object>]
      [-SecondValue <Object>]
      [-TypeConverter <Type>]
      [-TypeAdapter <Type>]
      [-SerializationMethod <String>]
      [-TargetTypeForDeserialization <Type>]
      [-SerializationDepth <Int32>]
      [-DefaultDisplayProperty <String>]
      [-InheritPropertySerializationSet <Nullable`1>]
      [-StringSerializationSource <String>]
      [-DefaultDisplayPropertySet <String[]>]
      [-DefaultKeyPropertySet <String[]>]
      [-PropertySerializationSet <String[]>]
      -TypeName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-TypeData
      [-Force]
      [-TypeData] <TypeData[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Tanım

Update-TypeData cmdlet'i, Types.ps1xml dosyalarını belleğe yeniden yükleyerek ve yeni genişletilmiş tür verileri ekleyerek oturumdaki genişletilmiş tür verilerini günceller.

Varsayılan olarak PowerShell, gerektiğinde genişletilmiş tür verilerini yükler. Parametreler olmadan, Update-TypeData, eklediğiniz tür dosyaları da dahil olmak üzere oturumda yüklediği tüm Types.ps1xml dosyalarını yeniden yükler. Yeni tür dosyaları eklemek ve genişletilmiş tür verilerini eklemek ve değiştirmek için Update-TypeData parametrelerini kullanabilirsiniz.

Update-TypeData cmdlet'i tüm tür verilerini önceden yüklemek için kullanılabilir. Bu özellik özellikle türler geliştirirken ve bu yeni türleri test amacıyla yüklemek istediğinizde kullanışlıdır.

Windows PowerShell 3.0'dan itibaren, Types.ps1xml dosyası kullanmadan oturumda genişletilmiş tür verilerini eklemek ve değiştirmek için Update-TypeData komutunu kullanabilirsiniz. Dinamik olarak yani dosyasız olarak eklenen tür verileri yalnızca geçerli oturuma eklenir. Tür verilerini tüm oturumlara eklemek için PowerShell profilinize bir Update-TypeData komutu ekleyin. Daha fazla bilgi için bkz. about_Profiles.

Ayrıca, Windows PowerShell 3.0'dan başlayarak, geçerli oturumdaki genişletilmiş türleri almak için Get-TypeData cmdlet'ini ve genişletilmiş türleri oturumdan silmek için Remove-TypeData cmdlet'ini kullanabilirsiniz. mevcut oturum.

Özelliklerde veya Update-TypeData komutuna özellik ekleme sırasında ortaya çıkan istisnalar, hataları bildirmez. Bunun amacı, biçimlendirme ve çıktı alma sırasında birçok yaygın türde ortaya çıkabilecek istisnaları ortadan kaldırmaktır. .NET özelliklerini alıyorsanız, aşağıdaki örnekte gösterildiği gibi bunun yerine yöntem sözdizimini kullanarak özel durumların gizlenmesine geçici bir çözüm bulabilirsiniz:

"hello".get_Length()

Yöntem sözdiziminin yalnızca .NET özellikleriyle kullanılabileceğini unutmayın. Update-TypeData cmdlet'i çalıştırılarak eklenen özellikler yöntem sözdizimini kullanamaz.

PowerShell'deki Types.ps1xml dosyaları hakkında daha fazla bilgi için bkz. about_Types.ps1xml.

Örnekler

Örnek 1: Genişletilmiş türleri güncelleme

Update-TypeData

Bu komut, oturumda zaten kullanılmış olan Types.ps1xml dosyalarından genişletilmiş tür yapılandırmasını günceller.

Örnek 2: Türleri birden çok kez güncelleme

Bu örnek, bir tür dosyasındaki türlerin aynı oturumda birden çok kez nasıl güncelleştirileceğini gösterir.

İlk komut, Types.ps1xml dosyalarından genişletilmiş tür yapılandırmasını günceller ve TypesA.types.ps1xml ve TypesB.types.ps1xml dosyalarını işler. Birinci.

İkinci komut, dosyaya bir tür eklediğinizde veya değiştirdiğinizde yapabileceğiniz gibi, TypesA.types.ps1xml dosyasının yeniden nasıl güncelleneceğini gösterir. TypesA.types.ps1xml dosyası için önceki komutu tekrarlayabilir veya TypesA.types.ps1xml< olduğundan parametresiz bir Update-TypeData komutunu çalıştırabilirsiniz. /code>, geçerli oturumun tür dosyası listesinde zaten var.

Update-TypeData -PrependPath TypesA.types.ps1xml, TypesB.types.ps1xml
Update-TypeData -PrependPath TypesA.types.ps1xml

Örnek 3: DateTime nesnelerine bir komut dosyası özelliği ekleme

Bu örnekte, Quarter komut dosyası özelliğini geçerli oturumdaki System.DateTime nesnelerine (örneğin, < tarafından döndürülenler) eklemek için Update-TypeData kullanılır.Get-Date cmdlet'i.

$typeDataParams = @{
    TypeName   = 'System.DateTime'
    MemberType = 'ScriptProperty'
    MemberName = 'Quarter'
    Value      = {
        switch ($this.Month) {
            { $_ -in @(1, 2, 3) } { return 'Q1' }
            { $_ -in @(4, 5, 6) } { return 'Q2' }
            { $_ -in @(7, 8, 9) } { return 'Q3' }
            default               { return 'Q4' }
        }
    }
}
Update-TypeData @typeDataParams

(Get-Date).Quarter

Q1

Update-TypeData komutu, System.DateTime türünü belirtmek için TypeName parametresini, belirtmek için de MemberName parametresini kullanır. yeni özellik için bir ad, ScriptProperty türünü belirtmek için MemberType özelliği ve yıllık çeyreği belirleyen komut dosyasını belirtmek için Value parametresi .

Value özelliğinin değeri, geçerli yıllık çeyreği hesaplayan bir komut dosyasıdır. Komut dosyası bloğu, nesnenin geçerli örneğini temsil etmek için $this otomatik değişkenini ve ay değerinin her tamsayı dizisinde görünüp görünmeyeceğini belirlemek için In operatörünü kullanır. -in operatörü hakkında daha fazla bilgi için bkz. about_Comparison_Operators.

İkinci komut, geçerli tarihin yeni Çeyrek özelliğini alır.

Örnek 4: Varsayılan olarak listelerde görüntülenen bir türü güncelleme

Bu örnek, varsayılan olarak listelerde görüntülenen, yani hiçbir özellik belirtilmediğinde bir türün özelliklerinin nasıl ayarlanacağını gösterir. Tür verileri bir Types.ps1xml dosyasında belirtilmediğinden yalnızca geçerli oturumda etkilidir.

Get-Date | Format-list

Update-TypeData -TypeName "System.DateTime" -DefaultDisplayPropertySet @(
    'DateTime'
    'DayOfYear'
    'Quarter'
)

Get-Date | Format-List

DisplayHint : DateTime
Date        : 8/7/2024 12:00:00 AM
Day         : 7
DayOfWeek   : Wednesday
DayOfYear   : 220
Hour        : 10
Kind        : Local
Millisecond : 568
Microsecond : 308
Nanosecond  : 600
Minute      : 34
Month       : 8
Second      : 43
Ticks       : 638586236835683086
TimeOfDay   : 10:34:43.5683086
Year        : 2024
DateTime    : Wednesday, August 7, 2024 10:34:43 AM
Quarter     : Q3


DateTime  : Wednesday, August 7, 2024 10:34:43 AM
DayOfYear : 220
Quarter   : Q3

İlk komut, geçerli tarihi temsil eden bir System.DateTime nesnesinin çıktısını veren Get-Date komutunun liste görünümünü gösterir. Komut, DateTime nesnesini Format-List cmdlet'ine göndermek için bir ardışık düzen operatörü (|) kullanır. Format-List komutu listede görüntülenecek özellikleri belirtmediğinden, PowerShell nesnenin tüm genel, gizli olmayan özelliklerini görüntüler.

İkinci komut, System.DateTime türüne ilişkin varsayılan liste özelliklerini ayarlamak için Update-TypeData cmdlet'ini kullanır. Komut, türü belirtmek için TypeName parametresini ve bir listenin varsayılan özelliklerini belirtmek için DefaultDisplayPropertySet parametresini kullanır. Seçilen özellikler, önceki örnekte eklenen yeni Çeyrek komut dosyası özelliğini içerir.

Son komut geçerli tarihi alır ve onu tekrar liste formatında görüntüler. Özelliklerin tam listesi yerine yalnızca Update-TypeData komutunda tanımlanan özellikleri görüntüler.

Örnek 5: Bir türün geniş formatta görüntülediği özelliği ayarlama

Bu örnek, yeni bir komut dosyası özelliğinin nasıl oluşturulacağını ve türün Format-Wide cmdlet'ine iletildiğinde görüntülenen varsayılan özellik olarak nasıl kullanılacağını gösterir.

Get-Command *File* | Format-Wide

Set-AppPackageProvisionedDataFile                            Set-ProvisionedAppPackageDataFile
Set-ProvisionedAppXDataFile                                  Write-FileSystemCache
Write-FileSystemCache                                        Add-PoshGitToProfile
Block-FileShareAccess                                        Clear-FileStorageTier
Close-SmbOpenFile                                            Debug-FileShare
Disable-NetIPHttpsProfile                                    Enable-NetIPHttpsProfile
Get-FileIntegrity                                            Get-FileShare
Get-FileShareAccessControlEntry                              Get-FileStorageTier
Get-NetConnectionProfile                                     Get-NetFirewallHyperVProfile
Get-NetFirewallProfile                                       Get-SmbOpenFile
Get-StorageFileServer                                        Get-SupportedFileSystems
Grant-FileShareAccess                                        New-FileShare
New-NetFirewallHyperVProfile                                 New-ScriptFileInfo
New-ScriptFileInfo                                           New-StorageFileServer
Publish-BCFileContent                                        Remove-FileShare
Remove-NetFirewallHyperVProfile                              Remove-PoshGitFromProfile
Remove-StorageFileServer                                     Repair-FileIntegrity
Revoke-FileShareAccess                                       Set-FileIntegrity
Set-FileShare                                                Set-FileStorageTier
Set-NetConnectionProfile                                     Set-NetFirewallHyperVProfile
Set-NetFirewallProfile                                       Set-StorageBusProfile
Set-StorageFileServer                                        Test-ScriptFileInfo
Test-ScriptFileInfo                                          Unblock-FileShareAccess
Update-ScriptFileInfo                                        Update-ScriptFileInfo
Add-BitsFile                                                 Get-AppLockerFileInformation
Get-FileHash                                                 Get-PSScriptFileInfo
Import-PowerShellDataFile                                    New-FileCatalog
New-PSRoleCapabilityFile                                     New-PSScriptFileInfo
New-PSSessionConfigurationFile                               New-TemporaryFile
Out-File                                                     Set-AppXProvisionedDataFile
Test-FileCatalog                                             Test-PSScriptFileInfo
Test-PSSessionConfigurationFile                              Unblock-File
Update-PSScriptFileInfo                                      FileDialogBroker.exe
FileHistory.exe                                              forfiles.exe
openfiles.exe

$typeDataParams = @{
    TypeName               = 'System.Management.Automation.CommandInfo'
    DefaultDisplayProperty = 'FullyQualifiedName'
    MemberType             = 'ScriptProperty'
    MemberName             = 'FullyQualifiedName'
    Value                  = {
        [OutputType([string])]
        param()

        # For executables, return the path to the application.
        if ($this -is [System.Management.Automation.ApplicationInfo]) {
            return $this.Path
        }

        # For commands defined outside a module, return only the name.
        if ([string]::IsNullOrEmpty($this.ModuleName)) {
            return $this.Name
        }

        # Return the fully-qualified command name "<ModuleName>\<CommandName>"
        return '{0}\{1}' -f $this.ModuleName, $this.Name
    }
}
Update-TypeData @typeDataParams

Get-Command *File* | Format-Wide

Dism\Set-AppPackageProvisionedDataFile                       Dism\Set-ProvisionedAppPackageDataFile
Dism\Set-ProvisionedAppXDataFile                             Storage\Write-FileSystemCache
VMDirectStorage\Write-FileSystemCache                        posh-git\Add-PoshGitToProfile
Storage\Block-FileShareAccess                                Storage\Clear-FileStorageTier
SmbShare\Close-SmbOpenFile                                   Storage\Debug-FileShare
NetworkTransition\Disable-NetIPHttpsProfile                  NetworkTransition\Enable-NetIPHttpsProfile
Storage\Get-FileIntegrity                                    Storage\Get-FileShare
Storage\Get-FileShareAccessControlEntry                      Storage\Get-FileStorageTier
NetConnection\Get-NetConnectionProfile                       NetSecurity\Get-NetFirewallHyperVProfile
NetSecurity\Get-NetFirewallProfile                           SmbShare\Get-SmbOpenFile
Storage\Get-StorageFileServer                                Storage\Get-SupportedFileSystems
Storage\Grant-FileShareAccess                                Storage\New-FileShare
NetSecurity\New-NetFirewallHyperVProfile                     PowerShellGet\New-ScriptFileInfo
PowerShellGet\New-ScriptFileInfo                             Storage\New-StorageFileServer
BranchCache\Publish-BCFileContent                            Storage\Remove-FileShare
NetSecurity\Remove-NetFirewallHyperVProfile                  posh-git\Remove-PoshGitFromProfile
Storage\Remove-StorageFileServer                             Storage\Repair-FileIntegrity
Storage\Revoke-FileShareAccess                               Storage\Set-FileIntegrity
Storage\Set-FileShare                                        Storage\Set-FileStorageTier
NetConnection\Set-NetConnectionProfile                       NetSecurity\Set-NetFirewallHyperVProfile
NetSecurity\Set-NetFirewallProfile                           StorageBusCache\Set-StorageBusProfile
Storage\Set-StorageFileServer                                PowerShellGet\Test-ScriptFileInfo
PowerShellGet\Test-ScriptFileInfo                            Storage\Unblock-FileShareAccess
PowerShellGet\Update-ScriptFileInfo                          PowerShellGet\Update-ScriptFileInfo
BitsTransfer\Add-BitsFile                                    AppLocker\Get-AppLockerFileInformation
Microsoft.PowerShell.Utility\Get-FileHash                    Microsoft.PowerShell.PSResourceGet\Get-PSScriptFileInfo        
Microsoft.PowerShell.Utility\Import-PowerShellDataFile       Microsoft.PowerShell.Security\New-FileCatalog
Microsoft.PowerShell.Core\New-PSRoleCapabilityFile           Microsoft.PowerShell.PSResourceGet\New-PSScriptFileInfo        
Microsoft.PowerShell.Core\New-PSSessionConfigurationFile     Microsoft.PowerShell.Utility\New-TemporaryFile
Microsoft.PowerShell.Utility\Out-File                        Dism\Set-AppXProvisionedDataFile
Microsoft.PowerShell.Security\Test-FileCatalog               Microsoft.PowerShell.PSResourceGet\Test-PSScriptFileInfo       
Microsoft.PowerShell.Core\Test-PSSessionConfigurationFile    Microsoft.PowerShell.Utility\Unblock-File
Microsoft.PowerShell.PSResourceGet\Update-PSScriptFileInfo   C:\WINDOWS\system32\FileDialogBroker.exe
C:\WINDOWS\system32\FileHistory.exe                          C:\WINDOWS\system32\forfiles.exe
C:\WINDOWS\system32\openfiles.exe

İlk komut, her komutu Dosya kelimesini içeren bir adla döndürmek için Get-Command cmdlet'ini kullanır. Çıktıyı, komutların adlarını sütunlarda gösteren Format-Wide cmdlet'ine yönlendirir.

Daha sonra örnekte, hem DefaultDisplayProperty'yi hem de CommandInfo türü için yeni bir komut dosyası özelliğini tanımlamak üzere Update-TypeData kullanılır. Get-Command çıktısı, CommandInfo nesnelerini ve bu türden türetilen nesneleri döndürür. Yeni komut dosyası özelliği, FullyQualifiedName, yürütülebilir uygulamaların tam yolunu ve cmdlet'ler için tam adı döndürür; bu, cmdlet adının önüne onu tanımlayan modülün eklenmesini sağlar. Update-TypeData cmdlet'i yeni komut dosyası özelliğini tanımlayabilir ve onu aynı komutta DefaultDisplayProperty olarak kullanabilir.

Son olarak çıktı, tür güncellemesinden sonra geniş formatta görüntülenen Get-Command sonuçlarını gösterir. Cmdlet'lerin tam adını ve yürütülebilir uygulamaların tam yolunu gösterir.

Örnek 6: Aktarılan bir nesne için tür verilerini güncelleme

$typeDataParams = @{
    MemberType = 'ScriptProperty'
    MemberName = 'SupportsUpdatableHelp'
    Value      = {
        [OutputType([bool])]
        param()

        return (-not [string]::IsNullOrEmpty($this.HelpInfoUri))
    }
}
Get-Module Microsoft.PowerShell.Utility | Update-TypeData @typeDataParams

Get-Module -ListAvailable -Name Microsoft.PowerShell.* |
    Format-Table Name, SupportsUpdatableHelp

Name                                      SupportsUpdatableHelp
----                                      ---------------------
Microsoft.PowerShell.Archive                               True
Microsoft.PowerShell.Diagnostics                           True
Microsoft.PowerShell.Host                                  True
Microsoft.PowerShell.Management                            True
Microsoft.PowerShell.PSResourceGet                         True
Microsoft.PowerShell.Security                              True
Microsoft.PowerShell.Utility                               True
Microsoft.PowerShell.Operation.Validation                  True
Microsoft.PowerShell.LocalAccounts                         True

Bu örnek, bir nesneyi Update-TypeData'ya yönlendirdiğinizde Update-TypeData'nın nesne türü için genişletilmiş tür verileri eklediğini gösterir.

Bu teknik, nesne türünü almak için Get-Member cmdlet'ini veya Get-Type yöntemini kullanmaktan daha hızlıdır. Ancak, bir nesne koleksiyonunu Update-TypeData'ya yönlendirirseniz, ilk nesne türünün tür verilerini günceller ve ardından üye zaten üzerinde tanımlı olduğundan koleksiyondaki diğer tüm nesneler için bir hata döndürür. türü.

İlk komut, Microsoft.PowerShell.Utility modülünü almak için Get-Module cmdlet'ini kullanır. Komut, modül nesnesini System.Management.Automation.PSModuleInfo türü ve bundan türetilen türler için tür verilerini güncelleyen Update-TypeData cmdlet'ine yönlendirir; ModuleInfoGrouping türü olarak, komutta ListAvailable parametresini kullandığınızda Get-Module'un döndürdüğü türdür.

Update-TypeData komutları, içe aktarılan tüm modüllere SupportsUpdatableHelp komut dosyası özelliğini ekler. Value parametresinin değeri, modülün HelpInfoUri özelliği doldurulursa ve $false< ise $true değerini döndüren bir komut dosyasıdır. /code> aksi halde.

İkinci komut, modül nesnelerini Get-Module'den Name ve SupportsUpdatableHelp'i görüntüleyen Format-Table cmdlet'ine yönlendirir. mevcut modüllerin özellikleri.

Parametreler

-AppendPath

İsteğe bağlı .ps1xml dosyalarının yolunu belirtir. Belirtilen dosyalar, yerleşik dosyalar yüklendikten sonra listelendikleri sırayla yüklenir. Ayrıca AppendPath değerini Update-TypeData'ya yönlendirebilirsiniz.

Tip :: String[]
Takma adlar:: PSPath, Path
Konum:: 0
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-Confirm

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

Tip :: SwitchParameter
Takma adlar:: cf
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-DefaultDisplayProperty

Başka hiçbir özellik belirtilmediğinde Format-Wide cmdlet'i tarafından görüntülenen türün özelliğini belirtir.

Türün standart veya genişletilmiş özelliğinin adını yazın. Bu parametrenin değeri aynı komuta eklenen bir türün adı olabilir.

Bu değer yalnızca Format.ps1xml dosyasında tür için tanımlanmış geniş görünüm olmadığında etkilidir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-DefaultDisplayPropertySet

Türün bir veya daha fazla özelliğini belirtir. Bu özellikler, başka bir özellik belirtilmediğinde Format-List, Format-Table ve Format-Custom cmdlet'leri tarafından görüntülenir.

Türün standart veya genişletilmiş özelliklerinin adlarını yazın. Bu parametrenin değeri aynı komuta eklenen türlerin adları olabilir.

Bu değer yalnızca Format.ps1xml dosyasında tür için tanımlanmış sırasıyla liste, tablo veya özel görünüm olmadığında etkilidir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-DefaultKeyPropertySet

Türün bir veya daha fazla özelliğini belirtir. Bu özellikler, başka bir özellik belirtilmediğinde Group-Object ve Sort-Object cmdlet'leri tarafından kullanılır.

Türün standart veya genişletilmiş özelliklerinin adlarını yazın. Bu parametrenin değeri aynı komuta eklenen türlerin adları olabilir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Force

Bu tür için tür verileri zaten belirtilmiş olsa bile cmdlet'in belirtilen tür verilerini kullandığını belirtir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-InheritPropertySerializationSet

Serileştirilen özellikler kümesinin devralınıp devralınmadığını gösterir. Varsayılan değer $Null'dur. Bu parametre için kabul edilebilir değerler şunlardır:

$True. Özellik kümesi devralınır.
$Yanlış. Özellik kümesi devralınmaz.
$Null. Miras tanımlanmamıştır.

Bu parametre yalnızca SerializationMethod parametresinin değeri SpecificProperties olduğunda geçerlidir. Bu parametrenin değeri $False olduğunda PropertySerializationSet parametresi gereklidir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Null yapılabilir[Boolean]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-MemberName

Bir özelliğin veya yöntemin adını belirtir.

Bir özelliği veya yöntemi eklemek veya değiştirmek için bu parametreyi TypeName, MemberType, Value ve SecondValue parametreleriyle birlikte kullanın. bir tür.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-MemberType

Eklenecek veya değiştirilecek üyenin türünü belirtir.

Bir özelliği veya yöntemi eklemek veya değiştirmek için bu parametreyi TypeName, MemberType, Value ve SecondValue parametreleriyle birlikte kullanın. bir tür. Bu parametre için kabul edilebilir değerler şunlardır:

AliasProperty
CodeMethod
CodeProperty
Not özelliği
ScriptMethod
ScriptProperty

Bu değerler hakkında bilgi için bkz. PSMemberTypes Numaralandırması.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: PSÜye Türleri
Kabul edilen değerler:: NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-PrependPath

İsteğe bağlı .ps1xml dosyalarının yolunu belirtir. Belirtilen dosyalar, yerleşik dosyalar yüklenmeden önce listelendikleri sırayla yüklenir.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-PropertySerializationSet

Serileştirilen özelliklerin adlarını belirtir. SerializationMethod parametresinin değeri SpecificProperties olduğunda bu parametreyi kullanın.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-SecondValue

AliasProperty, ScriptProperty, CodeProperty veya CodeMethod üyeleri için ek değerleri belirtir.

Bir özelliği veya yöntemi eklemek veya değiştirmek için bu parametreyi TypeName, MemberType, Value ve SecondValue parametreleriyle birlikte kullanın. bir tür.

MemberType parametresinin değeri AliasProperty olduğunda SecondValue parametresinin değeri bir veri türü olmalıdır. PowerShell, alias özelliğinin değerini belirtilen türe dönüştürür (yani yayınlar). Örneğin, bir dize özelliği için alternatif bir ad sağlayan bir takma ad özelliği eklerseniz, takma ad verilen dize değerini şuna dönüştürmek için System.Int32'nin SecondValue değerini de belirtebilirsiniz. bir tamsayı.

MemberType parametresinin değeri ScriptProperty olduğunda, ek bir komut dosyası bloğu belirtmek için SecondValue parametresini kullanabilirsiniz. Value parametresinin değerindeki komut dosyası bloğu, bir değişkenin değerini alır. SecondValue parametresinin değerindeki kod bloğu, değişkenin değerini ayarlar.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Nesne
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-SerializationDepth

Tür nesnelerinin kaç düzeyinin dize olarak serileştirileceğini belirtir. Varsayılan değer 1, nesneyi ve özelliklerini serileştirir. 0 değeri nesneyi serileştirir ancak özelliklerini serileştirmez. 2 değeri nesneyi, nesnenin özelliklerini ve özellik değerlerindeki tüm nesneleri serileştirir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Int32
Konum:: Adlandırılmış
Varsayılan değer:: 1
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-SerializationMethod

Tür için bir serileştirme yöntemini belirtir. Serileştirme yöntemi, türün hangi özelliklerinin serileştirileceğini ve bunları serileştirmek için kullanılan tekniği belirler. Bu parametre için kabul edilebilir değerler şunlardır:

TümPublicProperties. Türün tüm genel özelliklerini serileştirin. Alt özelliklerin serileştirilip serileştirilmediğini belirlemek için SerializationDepth parametresini kullanabilirsiniz.
Dize. Türü bir dize olarak serileştirin. Serileştirme sonucu olarak kullanılacak türün bir özelliğini belirtmek için StringSerializationSource'u kullanabilirsiniz. Aksi takdirde tür, nesnenin ToString yöntemi kullanılarak serileştirilir.
Belirli Özellikler. Bu türün yalnızca belirtilen özelliklerini serileştirin. Serileştirilen türün özelliklerini belirtmek için PropertySerializationSet parametresini kullanın. Ayrıca, özellik kümesinin devralınıp devralınmadığını belirlemek için InheritPropertySerializationSet parametresini ve alt özelliklerin serileştirilip serileştirilmediğini belirlemek için SerializationDepth parametresini de kullanabilirsiniz.

PowerShell'de serileştirme yöntemleri PSStandardMembers dahili nesnelerinde depolanır.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-StringSerializationSource

Türün bir özelliğinin adını belirtir. Belirtilen özelliğin değeri serileştirme sonucu olarak kullanılır. Bu parametre yalnızca SerializationMethod parametresinin değeri String olduğunda geçerlidir.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-TargetTypeForDeserialization

Bu türdeki nesnelerin seri durumdan çıkarıldığında dönüştürüleceği türü belirtir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Tip
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-TypeAdapter

Microsoft.PowerShell.Cim.CimInstanceAdapter gibi bir tür bağdaştırıcının türünü belirtir. Tür bağdaştırıcısı, PowerShell'in bir türün üyelerini almasını sağlar.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Tip
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-TypeConverter

Farklı türler arasındaki değerleri dönüştürmek için bir tür dönüştürücüyü belirtir. Bir tür için bir tür dönüştürücü tanımlanmışsa, dönüştürme için tür dönüştürücünün bir örneği kullanılır.

System.ComponentModel.TypeConverter veya System.Management.Automation.PSTypeConverter sınıflarından türetilen bir System.Type değeri girin.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Tip
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-TypeData

Bu cmdlet'in oturuma eklediği tür verilerinin dizisini belirtir. TypeData nesnesi içeren bir değişken veya TypeData nesnesi alan bir komut (örneğin, Get-TypeData komutu) girin. Ayrıca bir TypeData nesnesini Update-TypeData'ya yönlendirebilirsiniz.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Veri yazın[]
Konum:: 0
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-TypeName

Genişletilecek türün adını belirtir.

Sistem ad alanındaki türler için kısa adı girin. Aksi takdirde tam tür adı gereklidir. Joker karakterler desteklenmez.

Tür adlarını Update-TypeData'ya aktarabilirsiniz. Bir nesneyi Update-TypeData'ya aktardığınızda, Update-TypeData nesnenin tür adını alır ve nesne türüne veri yazın.

Bir özelliği veya yöntemi eklemek veya değiştirmek için bu parametreyi MemberName, MemberType, Value ve SecondValue parametreleriyle birlikte kullanın. bir tür.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-Value

Özelliğin veya yöntemin değerini belirtir.

Bir AliasProperty, CodeProperty, ScriptProperty veya CodeMethod üyesi eklerseniz SecondValue'yu kullanabilirsiniz parametresini kullanarak ek bilgi ekleyin.

Bir özelliği veya yöntemi eklemek veya değiştirmek için bu parametreyi MemberName, MemberType, Value ve SecondValue parametreleriyle birlikte kullanın. bir tür.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :: Nesne
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-WhatIf

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

Tip :: SwitchParameter
Takma adlar:: wi
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

Dize

AppendPath, TypeName veya TypeData parametrelerinin değerlerini içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Güncelleme TürüVerileri (Microsoft.PowerShell.Utility)

Update-TypeData

Sözdizimi

Tanım

Örnekler

Örnek 1: Genişletilmiş türleri güncelleme

Örnek 2: Türleri birden çok kez güncelleme

Örnek 3: DateTime nesnelerine bir komut dosyası özelliği ekleme

Örnek 4: Varsayılan olarak listelerde görüntülenen bir türü güncelleme

Örnek 5: Bir türün geniş formatta görüntülediği özelliği ayarlama

Örnek 6: Aktarılan bir nesne için tür verilerini güncelleme

Parametreler

-AppendPath

-Confirm

-DefaultDisplayProperty

-DefaultDisplayPropertySet

-DefaultKeyPropertySet

-Force

-InheritPropertySerializationSet

-MemberName

-MemberType

-PrependPath

-PropertySerializationSet

-SecondValue

-SerializationDepth

-SerializationMethod

-StringSerializationSource

-TargetTypeForDeserialization

-TypeAdapter

-TypeConverter

-TypeData

-TypeName

-Value

-WhatIf

Girişler

Çıkışlar

İlgili makaleler