Update-TypeData

Modül:

Microsoft.PowerShell.Utility

Oturumdaki genişletilmiş tür verilerini güncelleştirir.

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

Description

Cmdlet, Update-TypeData dosyaları belleğe yeniden yükleyip yeni genişletilmiş tür verileri ekleyerek oturumdaki Types.ps1xml genişletilmiş tür verilerini güncelleştirir.

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

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

Windows PowerShell 3.0'da başlayarak, oturumdaki genişletilmiş tür verilerini dosya kullanmadan Update-TypeData eklemek ve değiştirmek için kullanabilirsinizTypes.ps1xml. Dinamik olarak eklenen, yani dosya içermeyen tür verileri yalnızca geçerli oturuma eklenir. Tür verilerini tüm oturumlara eklemek için PowerShell profilinize bir Update-TypeData komut 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 cmdlet'ini ve Get-TypeData genişletilmiş türleri geçerli oturumdan silmek için cmdlet'ini kullanabilirsinizRemove-TypeData.

Özelliklerde veya bir Update-TypeData komuta özellik ekleme sırasında oluşan özel durumlar hataları bildirmez. Bu, biçimlendirme ve çıkış sırasında birçok yaygın türde ortaya çıkabilecek özel durumları engellemektir. .NET özellikleri alıyorsanız, aşağıdaki örnekte gösterildiği gibi bunun yerine yöntem söz dizimini kullanarak özel durumların gizlenmesiyle ilgili geçici bir çözüm bulabilirsiniz:

"hello".get_Length()

Yöntem söz dizimlerinin yalnızca .NET özellikleriyle kullanılabileceğini unutmayın. cmdlet'i çalıştırılarak Update-TypeData eklenen özellikler yöntem söz dizimini 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üncelleştirme

Update-TypeData

Bu komut, oturumda zaten kullanılmış olan dosyalardan Types.ps1xml genişletilmiş tür yapılandırmasını güncelleştirir.

Örnek 2: Türleri birden çok kez güncelleştirme

Bu örnekte, aynı oturumda bir tür dosyasındaki türlerin birden çok kez nasıl güncelleştirilecekleri gösterilmektedir.

İlk komut, genişletilmiş tür yapılandırmasını dosyalardan Types.ps1xml güncelleştirir, önce ve TypesA.types.ps1xml dosyalarını işlerTypesB.types.ps1xml.

İkinci komut, dosyaya TypesA.types.ps1xml bir tür eklediyseniz veya değiştirdiyseniz yapabileceğiniz gibi öğesinin nasıl yeniden güncelleştirildiğini gösterir. Dosya için önceki komutu yineleyebilir veya geçerli oturumun TypesA.types.ps1xml tür dosyası listesinde olduğundan Update-TypeData parametresiz bir TypesA.types.ps1xml komut çalıştırabilirsiniz.

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

Örnek 3: DateTime nesnelerine betik özelliği ekleme

Bu örnek, cmdlet'i tarafından Update-TypeData döndürülenler gibi geçerli oturumdaki System.DateTime nesnelerine Quarter betiği özelliğini eklemek için kullanırGet-Date.

$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

Komut, Update-TypeData System.DateTime türünü belirtmek için TypeName parametresini, yeni özelliğin adını belirtmek için MemberName parametresini, ScriptProperty türünü belirtmek için MemberType özelliğini ve yıllık üç aylık dönemi belirleyen betiği belirtmek için Value parametresini kullanır.

Value özelliğinin değeri, geçerli yıllık üç aylık dönemi hesaplayan bir betiktir. Betik bloğu, nesnenin $this geçerli örneğini temsil etmek için otomatik değişkeni ve ay değerinin her tamsayı dizisinde görünüp görünmediğini belirlemek için In işlecini kullanır. İşleç -in hakkında daha fazla bilgi için bkz . about_Comparison_Operators.

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

Örnek 4: Listelerde varsayılan olarak görüntülenen bir türü güncelleştirme

Bu örnekte, listelerde varsayılan olarak görüntülenen bir türün özelliklerini ayarlama işlemi (başka bir ifadeyle, hiçbir özellik belirtilmediğinde) gösterilmektedir. Tür verileri bir Types.ps1xml dosyada 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 Get-Date nesnesinin çıkışını veren komutun liste görünümünü gösterir. Komut, DateTime|için bir işlem hattı işleci (Format-List) kullanır. Format-List Komut listede görüntülenecek özellikleri belirtmediğinden, PowerShell nesne için genel, gizli olmayan her özelliği görüntüler.

İkinci komut, System.DateTimeUpdate-TypeDatakullanır. komutu type değerini belirtmek için TypeName parametresini ve listenin varsayılan özelliklerini belirtmek için DefaultDisplayPropertySet parametresini kullanır. Seçilen özellikler, önceki örnekte eklenen yeni Quarter betiği özelliğini içerir.

Son komut geçerli tarihi alır ve yeniden liste biçiminde görüntüler. Özelliklerin tam listesi yerine yalnızca komutta Update-TypeData tanımlanan özellikleri görüntüler.

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

Bu örnekte, yeni bir betik özelliğinin nasıl oluşturulacağı ve tür cmdlet'e Format-Wide geçirildiğinde görüntülenen varsayılan özellik olarak nasıl kullanılacağı gösterilmektedir.

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 cmdlet'ini Get-Command kullanarak sözcüğünü Fileiçeren bir ada sahip her komutu döndürür. Çıkışı, komutların Format-Wide adlarını sütunlarda gösteren cmdlet'ine aktarır.

Daha sonra örnek, CommandInfo türü için hem DefaultDisplayPropertyUpdate-TypeDatayeni bir betik özelliğini tanımlamak için kullanır. için Get-Command çıkış, bu türden türetilen CommandInfo nesnelerini ve nesnelerini döndürür. FullyQualifiedName adlı yeni betik özelliği, yürütülebilir uygulamaların tam yolunu ve cmdlet'ler için cmdlet adını tanımlayan modüle ön ekleyen tam adı döndürür. Update-TypeData Cmdlet, yeni betik özelliğini tanımlayabilir ve aynı komutta DefaultDisplayProperty olarak kullanabilir.

Son olarak çıkış, tür güncelleştirmesinin Get-Command ardından geniş biçimde görüntülenen sonuçlarını gösterir. Cmdlet'ler için tam adı ve yürütülebilir uygulamaların tam yolunu gösterir.

Örnek 6: Kanallı nesne için tür verilerini güncelleştirme

$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 örnekte, bir nesneyi öğesine Update-TypeDataUpdate-TypeData yönelttiğiniz zaman nesne türü için genişletilmiş tür verileri eklendiğini gösterir.

Bu teknik, nesne türünü almak için cmdlet'ini Get-Member veya yöntemini kullanmaktan Get-Type daha hızlıdır. Ancak, bir nesne koleksiyonunu öğesine Update-TypeDatayönelterseniz, ilk nesne türünün tür verilerini güncelleştirir ve ardından üye türü üzerinde zaten tanımlandığından koleksiyondaki diğer tüm nesneler için bir hata döndürür.

İlk komut, Microsoft.PowerShell.UtilityGet-Modulekullanır. komut, modül nesnesini cmdlet'ine Update-TypeData aktarır. Bu, System.Management.Automation.PSModuleInfo türü için tür verilerini ve komutunda ListAvailable parametresini kullandığınızda döndürülen ModuleInfoGrouping türü Get-Module gibi tür türlerini güncelleştirir.

Komutlar, Update-TypeData içeri aktarılan tüm modüllere SupportsUpdatableHelp betiği özelliğini ekler. Value parametresinin $false

İkinci komut, modül nesneleriniGet-Module, kullanılabilir modüllerin Format-Table Name ve SupportsUpdatableHelp özelliklerini görüntüleyen cmdlet'ine aktarır.

Parametreler

-AppendPath

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

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

-DefaultDisplayProperty

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

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

Bu değer yalnızca bir dosyadaki Format.ps1xml tür için tanımlanmış geniş görünümler olmadığında geçerlidir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	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-Listve Format-Table cmdlet'leri tarafından Format-Customgörüntülenir.

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

Bu değer yalnızca bir dosyadaki Format.ps1xml tür için sırasıyla tanımlı liste, tablo veya özel görünüm olmadığında geçerlidir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	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 ve Group-Object cmdlet'leri tarafından Sort-Object kullanılır.

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

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-Force

Cmdlet'in, bu tür için önceden tür verileri belirtilmiş olsa bile belirtilen tür verilerini kullandığını gösterir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-InheritPropertySerializationSet

Seri hale getirilmiş özellik kümesinin devralınıp devralınmadığını gösterir. Varsayılan değer şudur: $Null. Bu parametrenin kabul edilebilir değerleri şunlardır:

• $True. Özellik kümesi devralınır.
• $False. Özellik kümesi devralınmıyor.
• $Null. Devralma tanımlanmadı.

Bu parametre yalnızca SerializationMethod parametresinin değeri olduğunda SpecificPropertiesgeçerlidir. Bu parametrenin değeri olduğunda $FalsePropertySerializationSet parametresi gereklidir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-MemberName

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

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

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-MemberType

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

Türün bir özelliğini veya yöntemini eklemek veya değiştirmek için bu parametreyi TypeName, MemberType, Value ve SecondValue parametreleriyle kullanın. Bu parametrenin kabul edilebilir değerleri ş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ıma sunulmuştur.

Tür:	PSMemberTypes
Kabul edilen değerler:	NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-PrependPath

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

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

-PropertySerializationSet

Seri hale getirilmiş özelliklerin adlarını belirtir. SerializationMethod parametresinin değeri SpecificProperties olduğunda 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

-SecondValue

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

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

MemberType parametresinin değeri olduğundaAliasProperty, SecondValue parametresinin değeri bir veri türü olmalıdır. PowerShell, diğer ad özelliğinin değerini belirtilen türe dönüştürür (başka bir ifadeyle yayınlar). Örneğin, dize özelliği için alternatif bir ad sağlayan bir diğer ad özelliği eklerseniz, diğer adı alınan dize değerini tamsayıya dönüştürmek için Bir SecondValue of System.Int32 de belirtebilirsiniz.

MemberType parametresinin değeri olduğunda, ek bir betik bloğu belirtmek için SecondValueScriptProperty. Value parametresinin değerindeki betik bloğu bir değişkenin değerini alır. SecondValue parametresinin değerindeki betik bloğu değişkeninin değerini ayarlar.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-SerializationDepth

Tür nesnelerinin dize olarak seri hale getirilebileceği düzey sayısını belirtir. Varsayılan değer 1 , nesneyi ve özelliklerini serileştirir. değeri 0 nesnesini serileştirir, ancak özelliklerini seri hale getirmez. değeri 2 , nesnesini, özelliklerini ve özellik değerlerindeki nesneleri serileştirir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Tür:	Int32
Position:	Named
Default value:	1
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SerializationMethod

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

• AllPublicProperties. Türün tüm genel özelliklerini seri hale getirme. Alt özelliklerin seri hale getirilip getirilmediğini belirlemek için SerializationDepth parametresini kullanabilirsiniz.
• String. Türü dize olarak seri hale getirme. Serileştirme sonucu olarak kullanılacak türün bir özelliğini belirtmek için StringSerializationSource kullanabilirsiniz. Aksi takdirde, türü nesnenin ToString yöntemi kullanılarak serileştirilir.
• SpecificProperties. Yalnızca bu türün belirtilen özelliklerini seri hale getir. Seri hale getirilmiş 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 iç nesnelerinde depolanır.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-StringSerializationSource

türündeki bir özelliğin 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.

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

-TargetTypeForDeserialization

Seri durumdan çıkarıldığında bu türdeki nesnenin dönüştürüldüğü türü belirtir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-TypeAdapter

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

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-TypeConverter

Değerleri farklı türler arasında dönüştürmek için bir tür dönüştürücüsü belirtir. Tür dönüştürücüsü bir tür için tanımlanmışsa, dönüştürme için tür dönüştürücüsü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ıma sunulmuştur.

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

-TypeData

Bu cmdlet'in oturuma eklediği tür veri dizisini belirtir. TypeData nesnesi veya komut gibi bir TypeData nesnesi alan bir komut içeren bir Get-TypeData değişken girin. Bir TypeDataUpdate-TypeData.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-TypeName

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

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

Tür adlarını adresine Update-TypeDatayöneltebilirsiniz. Bir nesneyi öğesine Update-TypeDataUpdate-TypeData yönelttiğiniz zaman, nesnenin tür adını alır ve veri türünü nesne türüne yazar.

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

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-Value

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

Bir AliasProperty, CodeProperty, ScriptPropertyveya CodeMethod üyesi eklerseniz, ek bilgi eklemek için SecondValue parametresini kullanabilirsiniz.

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

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Tür:	Object
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

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

Çıkışlar

None

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

İlişkili Bağlantılar

• about_Types.ps1xml
• Get-TypeData
• Remove-TypeData