Aracılığıyla paylaş

Update-TypeData

Modül:
Microsoft.PowerShell.Utility Module

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

Sözdizimi

FileSet EnterprisePublishing 

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

DynamicTypeSet 

Update-TypeData
    -TypeName <String>
    [-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[]>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

TypeDataSet 

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

Description

Update-TypeData cmdlet'i, Types.ps1xml dosyalarını belleğe yeniden yükleyip yeni genişletilmiş tür verileri ekleyerek oturumdaki 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ı 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ü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, Update-TypeData dosyası kullanmadan oturumdaki genişletilmiş tür verilerini eklemek ve değiştirmek için Types.ps1xml kullanabilirsiniz. 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 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 geçerli oturumdan silmek için Remove-TypeData cmdlet'ini kullanabilirsiniz.

Özelliklerde veya Update-TypeData komutuna ö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 elde ediyorsanız, aşağıdaki örnekte gösterildiği gibi bunun yerine yöntem söz dizimini kullanarak istisnaların bastırılmasına karşı bir çözüm bulabilirsiniz.

"hello".get_Length()

Yöntem söz dizimlerinin yalnızca .NET özellikleriyle kullanılabileceğini unutmayın. Update-TypeData cmdlet'i çalıştırılarak 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 Types.ps1xml dosyalarından 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, Types.ps1xml dosyalarından genişletilmiş tür yapılandırmasını güncelleştirir ve önce TypesA.types.ps1xml ve TypesB.types.ps1xml dosyaları işler.

İkinci komut, dosyaya bir tür eklediğinizde veya değiştirdiğinizde yapabileceğiniz gibi TypesA.types.ps1xml nasıl yeniden güncelleştirildiğini gösterir. TypesA.types.ps1xml dosyası için önceki komutu yineleyebilir veya parametreler olmadan bir Update-TypeData komutu çalıştırabilirsiniz, çünkü TypesA.types.ps1xml zaten geçerli oturumun tür dosyası listesindedir.

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, Update-TypeData cmdlet'i tarafından döndürülenler gibi geçerli oturumdaki System.DateTime nesneleriniQuarter betik özelliğini eklemek için Get-Date kullanır.

$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ü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 çeyreği belirleyen betiği belirtmek için Değer parametresini kullanır.

Değeri özelliğinin değeri, geçerli yıllık üç aylık dönemi hesaplayan bir betiktir. Betik 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ünmediğini belirlemek için In işlecini kullanır. -in işleci hakkında daha fazla bilgi almak için about_Comparison_Operators'ye bakın.

İ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 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 Get-Date nesnesi çıkaran komutunun liste görünümünü gösterir. Komut, | nesnesini cmdlet'ine göndermek için bir işlem hattı işleci (Format-List) kullanır. Format-List komutu listede görüntülenecek özellikleri belirtmediğinden, PowerShell nesne için genel, gizli olmayan tüm özellikleri görüntüler.

İkinci komut, Update-TypeData türünün varsayılan liste özelliklerini ayarlamak için cmdlet'ini kullanır. Komut, türü belirtmek için TypeName parametresini ve listenin varsayılan özelliklerini belirtmek için DefaultDisplayPropertySet parametresini kullanır. Seçilen özellikler, önceki örnekte eklenen yeni Çeyrek betik ö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 Update-TypeData komutunda 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 Format-Wide cmdlet'ine 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, Get-Command cmdlet'ini kullanarak Filesözcüğünü içeren bir ada sahip her komutu döndürür. Çıkışı, komutların adlarını sütunlarda gösteren Format-Wide cmdlet'ine aktarır.

Daha sonra örnek, Update-TypeData ve CommandInfo türü için yeni bir betik özelliği tanımlamak için kullanır. Get-Command çıktısı, bu türden türetilen CommandInfo nesneleri ve nesneleri döndürür. FullyQualifiedName 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'i yeni betik özelliğini tanımlayabilir ve aynı komutta DefaultDisplayProperty olarak kullanabilir.

Son olarak çıkış, tür güncelleştirmesinin ardından geniş biçimde görüntülenen Get-Command 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 Update-TypeDataUpdate-TypeData nesne türü için genişletilmiş tür verileri eklediği gösterilmektedir.

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

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

Update-TypeData komutları, içeri aktarılan tüm modüllere SupportsUpdatableHelp betik özelliğini ekler. Value parametresinin değeri, modülün $true özelliği doldurulup değilse $false döndüren bir betiktir.

İkinci komut, modül nesnelerini Get-ModuleFormat-Table cmdlet'ine aktarır. Bu komut, kullanılabilir modüllerin Adı ve SupportsUpdatableHelp özelliklerini.

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 bir AppendPath değerini Update-TypeData'e de yöneltebilirsiniz.

Parametre özellikleri

Tür:

String[]

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

Parametre kümeleri

FileSet
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

-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ı komutta eklenen bir türün adı olabilir.

Bu değer yalnızca bir Format.ps1xml dosyasında 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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-DefaultDisplayPropertySet

Türün bir veya daha fazla özelliğini belirtir. Bu özellikler, başka hiçbir özellik belirtilmediğinde Format-List, Format-Tableve 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ı komutta eklenen türlerin adları olabilir.

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

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-DefaultKeyPropertySet

Türün bir veya daha fazla özelliğini belirtir. Bu özellikler, başka hiç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ı komutta eklenen türlerin adları olabilir.

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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
TypeDataSet
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

-InheritPropertySerializationSet

Seri hale getirilmiş özellik kümesinin devralınıp devralınmadığını gösterir. Varsayılan değer şudur: $null. Bu parametre için kabul edilebilir değerler ş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 SpecificPropertiesolduğunda geçerlidir. Bu parametrenin değeri $falseolduğunda, PropertySerializationSet parametresi gerekir.

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

Parametre özellikleri

Tür:

Nullable<T>[Boolean]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-MemberName

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

Bir türün ö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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-MemberType

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

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

Parametre özellikleri

Tür:PSMemberTypes
Default value:None
Kabul edilen değerler:NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

FileSet
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

-PropertySerializationSet

Seri hale getirilmiş özelliklerin adlarını belirtir. SerializationMethod parametresinin değeri SpecificPropertiesolduğunda bu parametreyi kullanın.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-SecondValue

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

Bu parametreyi typename , MemberType, Valueve SecondValue parametreleriyle kullanarak bir türün özelliğini veya yöntemini ekleyin veya değiştirin.

MemberType parametresinin değeri AliasPropertyolduğunda, 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 System.Int32SecondValue da belirtebilirsiniz.

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

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

Parametre özellikleri

Tür:Object
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-SerializationDepth

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

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

Parametre özellikleri

Tür:Int32
Default value:1
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-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 parametre için kabul edilebilir değerler şunlardır:

  • AllPublicProperties. Türün tüm genel özelliklerini seri hale getirme. Alt özelliklerin serileştirilip serileştirilmediğ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ç nesnelerde depolanır.

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

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

Parametre özellikleri

Tür:Type
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-TypeAdapter

Microsoft.PowerShell.Cim.CimInstanceAdaptergibi 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.

Parametre özellikleri

Tür:Type
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

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

Parametre özellikleri

Tür:Type
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

-TypeData

Bu cmdlet'in oturuma eklediği tür veri dizisini belirtir. TypeData nesnesi veya komutu gibi Get-TypeData nesnesi alan bir komut içeren bir değişken girin. Ayrıca TypeData nesnesini Update-TypeData'e de yöneltebilirsiniz.

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

Parametre özellikleri

Tür:

TypeData[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

TypeDataSet
Position:0
Zorunlu:True
İş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

-TypeName

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

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

Tür adlarını Update-TypeDatakanala ekleyebilirsiniz. bir nesneyi Update-TypeData'a yönelttiğinde Update-TypeData nesnenin tür adını alır ve veri türünü nesne türüne yazar.

Bu parametreyi MemberName, MemberType, Value ve SecondValue parametreleriyle kullanarak bir türe ait özellik veya yöntemi ekleyin veya değiştirin.

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Ö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

-Value

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

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

Bu parametreyi MemberName, MemberType, Value ve SecondValue parametreleriyle kullanarak bir türe ait özellik veya yöntemi ekleyin veya değiştirin.

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

Parametre özellikleri

Tür:Object
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DynamicTypeSet
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

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

Çıkışlar

None

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