Update-TypeData

Referencia

Modul:: Microsoft.PowerShell.Utility

Frissíti a munkamenet kiterjesztett típusadatait.

Syntax

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

A Update-TypeData parancsmag frissíti a munkamenet kiterjesztett típusadatait a fájlok memóriába való Types.ps1xml újratöltésével és új kiterjesztett típusú adatok hozzáadásával.

A PowerShell alapértelmezés szerint szükség szerint betölti a kiterjesztett típusadatokat. Paraméterek Update-TypeData nélkül újra betölti a Types.ps1xml munkamenetbe betöltött összes fájlt, beleértve a hozzáadott típusfájlokat is. A paraméterekkel új típusfájlokat Update-TypeData adhat hozzá, és kiterjesztett típusadatokat adhat hozzá és cserélhet le.

A Update-TypeData parancsmag az összes típusadat előzetes betöltésére használható. Ez a funkció különösen akkor hasznos, ha típusokat fejleszt, és tesztelési célokra szeretné betölteni ezeket az új típusokat.

A Windows PowerShell 3.0-tól kezdődően fájl használata Types.ps1xml nélkül is hozzáadhat és lecserélhet Update-TypeData bővített típusú adatokat a munkamenetben. Írja be a dinamikusan hozzáadott adatokat, azaz fájl nélkül csak az aktuális munkamenethez. Ha minden munkamenethez hozzá szeretné adni a típusadatokat, adjon hozzá egy Update-TypeData parancsot a PowerShell-profiljához. További információ: about_Profiles.

A Windows PowerShell 3.0-tól kezdve a Get-TypeData parancsmaggal lekérheti az aktuális munkamenet kiterjesztett típusait, a Remove-TypeData parancsmag pedig törölheti a bővített típusokat az aktuális munkamenetből.

A tulajdonságokban vagy a tulajdonságok parancshoz való Update-TypeData hozzáadásában előforduló kivételek nem jelentik a hibákat. Ez a formázás és a kimenetelés során gyakran előforduló kivételek mellőzése. Ha .NET-tulajdonságokat kap, a kivételek mellőzése megkerülhető módszerszintaxis használatával, ahogyan az alábbi példában látható:

"hello".get_Length()

Vegye figyelembe, hogy a metódusszintaxis csak .NET-tulajdonságokkal használható. A parancsmag futtatásával hozzáadott tulajdonságok nem használhatják a Update-TypeData metódus szintaxisát.

A PowerShellben található Types.ps1xml fájlokkal kapcsolatos további információkért lásd: about_Types.ps1xml.

Példák

1. példa: Kiterjesztett típusok frissítése

Update-TypeData

Ez a parancs frissíti a kiterjesztett típuskonfigurációt a Types.ps1xml munkamenetben már használt fájlokból.

2. példa: A típusok többszöri frissítése

Ez a példa bemutatja, hogyan frissítheti a típusfájl típusait többször ugyanabban a munkamenetben.

Az első parancs frissíti a fájlok kiterjesztett Types.ps1xml típuskonfigurációját, először feldolgozva azokat és TypesB.types.ps1xml a TypesA.types.ps1xml fájlokat.

A második parancs bemutatja, hogyan frissítheti újra a TypesA.types.ps1xml fájlt, például ha hozzáadott vagy módosított egy típust a fájlban. Megismételheti a TypesA.types.ps1xml fájl előző parancsát, vagy futtathat paraméterek nélkül egy Update-TypeData parancsot, mert TypesA.types.ps1xml már szerepel az aktuális munkamenet típusfájllistájában.

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

3. példa: Szkripttulajdonság hozzáadása DateTime-objektumokhoz

Ez a példa a Quarter szkript tulajdonság hozzáadását használja Update-TypeData az aktuális munkamenet System.DateTime objektumaihoz, például a Get-Date parancsmag által visszaadott objektumokhoz.

$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

A Update-TypeData parancs a TypeName paraméterrel adja meg a System.DateTime típust, a MemberName paramétert az új tulajdonság nevének megadásához, a MemberType tulajdonságot a ScriptProperty típus megadásához, az Érték paramétert pedig az éves negyedévet meghatározó szkript megadásához.

Az Érték tulajdonság értéke egy szkript, amely kiszámítja az aktuális éves negyedévet. A szkriptblokk az automatikus változót használja az $this objektum aktuális példányának és az In operátornak a meghatározásához, hogy a hónap értéke megjelenjen-e az egyes egész számtömbökben. Az operátorral kapcsolatos további információkért lásd: -in about_Comparison_Operators.

A második parancs lekéri az aktuális dátum új Quarter tulajdonságát.

4. példa: A listákban alapértelmezés szerint megjelenő típus frissítése

Ez a példa bemutatja, hogyan állíthatja be a listákban alapértelmezés szerint megjelenő típus tulajdonságait, vagyis ha nincs megadva tulajdonság. Mivel a típusadatok nincsenek megadva egy Types.ps1xml fájlban, csak az aktuális munkamenetben érvényesek.

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

Az első parancs megjeleníti a parancs listanézetét Get-Date , amely egy System.DateTime objektumot ad ki, amely az aktuális dátumot jelöli. A parancs folyamatkezelővel (|) küldi el a DateTime objektumot a Format-List parancsmagnak. Mivel a Format-List parancs nem adja meg a listában megjelenítendő tulajdonságokat, a PowerShell megjeleníti az objektum összes nyilvános, nem rejtett tulajdonságát.

A második parancs a Update-TypeData parancsmaggal állítja be a System.DateTime típus alapértelmezett listatulajdonságát. A parancs a TypeName paraméterrel adja meg a típust és a DefaultDisplayPropertySet paramétert a lista alapértelmezett tulajdonságainak megadásához. A kijelölt tulajdonságok közé tartozik az előző példában hozzáadott új Quarter szkripttulajdonság.

Az utolsó parancs lekéri a currnet dátumát, és ismét listaformátumban jeleníti meg. Csak a parancsban Update-TypeData definiált tulajdonságokat jeleníti meg a tulajdonságok teljes listája helyett.

5. példa: A tulajdonság típusának beállítása széles formátumban

Ez a példa bemutatja, hogyan hozhat létre új szkripttulajdonságot, és hogyan használhatja azt alapértelmezett tulajdonságként, amikor a típust átadják a Format-Wide parancsmagnak.

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

Az első parancs a parancsmaggal adja vissza a Get-Command szót Filetartalmazó összes parancsot. A kimenetet a Format-Wide parancsmagra irányítja, amely oszlopokban jeleníti meg a parancsok nevét.

A példa a DefaultDisplayProperty és a CommandInfo típus új szkripttulajdonságának definiálására is használhatóUpdate-TypeData. A kimenet az Get-Command adott típusból származtatott CommandInfo-objektumokat és objektumokat adja vissza. Az új szkripttulajdonság( FullQualifiedName) visszaadja a végrehajtható alkalmazások teljes elérési útját, valamint a parancsmagok teljes nevét, amely előtagként a parancsmag nevét az azt meghatározó modullal adhatja meg. A Update-TypeData parancsmag meg tudja határozni az új szkripttulajdonságot, és használhatja defaultDisplayPropertyként ugyanabban a parancsban.

Végül a kimenet a típusfrissítés után széles formátumban megjelenített eredményeket Get-Command jeleníti meg. Megjeleníti a parancsmagok teljes nevét és a végrehajtható alkalmazások teljes elérési útját.

6. példa: Piped object típusadatainak frissítése

$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

Ez a példa azt mutatja be, hogy amikor egy objektumot az objektumba Update-TypeDatacsövez, Update-TypeData kiterjesztett típusadatokat ad hozzá az objektumtípushoz.

Ez a technika gyorsabb, mint a Get-Member parancsmag vagy a Get-Type metódus használata az objektumtípus lekéréséhez. Ha azonban egy objektumgyűjteményt Update-TypeDataad vissza, az frissíti az első objektumtípus típusadatait, majd hibát ad vissza a gyűjtemény összes többi objektumára vonatkozóan, mert a tag már definiálva van a típuson.

Az első parancs a Get-Module parancsmagot használja a Microsoft.PowerShell.Utility modul lekéréséhez. A parancs a modulobjektumot a Update-TypeData parancsmagra irányítja, amely frissíti a System.Management.Automation.PSModuleInfo típus és az abból származtatott típusok típusadatait, például a Parancs ListAvailable paraméterének használatakor visszaadott ModuleInfoGrouping típustGet-Module.

A Update-TypeData parancsok hozzáadják a SupportsUpdatableHelp szkripttulajdonságot az összes importált modulhoz. Az Érték paraméter értéke egy szkript, amely akkor ad vissza$true, ha a modul HelpInfoUri tulajdonsága fel van töltve, egyébként$false.

A második parancs a modulobjektumokat a parancsmagba Get-Module irányítja, amely megjeleníti a rendelkezésre álló modulok Nevét és SupportsUpdatableHelp tulajdonságait.Format-Table

Paraméterek

-AppendPath

Megadja az opcionális .ps1xml fájlok elérési útját. A megadott fájlok a beépített fájlok betöltése után a lista szerinti sorrendben lesznek betöltve. Egy AppendPath-értéket is becsúszthat a programbaUpdate-TypeData.

Típus:	String[]
Aliasok:	PSPath, Path
Position:	0
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultDisplayProperty

Annak a típusnak a tulajdonságát adja meg, amelyet a Format-Wide parancsmag akkor jelenít meg, ha nincs más tulajdonság megadva.

Írja be a típus szabványos vagy kiterjesztett tulajdonságának nevét. Ennek a paraméternek az értéke lehet egy olyan típus neve, amely ugyanabban a parancsban van hozzáadva.

Ez az érték csak akkor érvényes, ha a fájl típusához Format.ps1xml nincs definiálva széles nézet.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultDisplayPropertySet

A típus egy vagy több tulajdonságát adja meg. Ezeket a tulajdonságokat a , Format-Tableés Format-Custom parancsmagok Format-Listjelenítik meg, ha nincs más tulajdonság megadva.

Írja be a típus szabványos vagy kiterjesztett tulajdonságainak nevét. Ennek a paraméternek az értéke lehet az ugyanazon parancsban hozzáadott típusok neve.

Ez az érték csak akkor érvényes, ha a fájl típusához Format.ps1xml nincs definiálva lista, táblázat vagy egyéni nézet.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultKeyPropertySet

A típus egy vagy több tulajdonságát adja meg. Ezeket a tulajdonságokat a parancsmagok és Sort-Object a Group-Object parancsmagok használják, ha nincs más tulajdonság megadva.

Írja be a típus szabványos vagy kiterjesztett tulajdonságainak nevét. Ennek a paraméternek az értéke lehet az ugyanazon parancsban hozzáadott típusok neve.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Force

Azt jelzi, hogy a parancsmag a megadott típusadatokat használja, még akkor is, ha a típushoz már meg van adva típusadatok.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-InheritPropertySerializationSet

Azt jelzi, hogy a szerializált tulajdonságok halmaza öröklődik-e. Az alapértelmezett érték $Null. A paraméter elfogadható értékei a következők:

$True. A tulajdonságkészlet öröklődik.
$False. A tulajdonságkészlet nem öröklődik.
$Null. Az öröklés nincs definiálva.

Ez a paraméter csak akkor érvényes, ha a SzerializálásMethod paraméter értéke .SpecificProperties Ha ennek a paraméternek az értéke, $Falsea PropertySerializationSet paraméter szükséges.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Nullable<T>[Boolean]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-MemberName

Egy tulajdonság vagy metódus nevét adja meg.

Ezt a paramétert a TypeName, a MemberType, az Value és a SecondValue paraméterekkel használhatja egy típus tulajdonságának vagy metódusának hozzáadásához vagy módosításához.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-MemberType

Megadja a hozzáadni vagy módosítani kívánt tag típusát.

Ezt a paramétert a TypeName, a MemberType, az Value és a SecondValue paraméterekkel használhatja egy típus tulajdonságának vagy metódusának hozzáadásához vagy módosításához. A paraméter elfogadható értékei a következők:

AliasProperty
CodeMethod
CodeProperty
Jegyzetproperty
ScriptMethod
ScriptProperty

Ezekről az értékekről további információt a PSMemberTypes Enumerálás című témakörben talál.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	PSMemberTypes
Elfogadott értékek:	NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PrependPath

Megadja az opcionális .ps1xml fájlok elérési útját. A megadott fájlok betöltése a lista szerinti sorrendbe kerül a beépített fájlok betöltése előtt.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PropertySerializationSet

Megadja a szerializált tulajdonságok nevét. Ezt a paramétert akkor használja, ha a SzerializálásMethod paraméter értéke SpecificProperties.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SecondValue

További értékeket ad meg az AliasProperty, a ScriptProperty, a CodeProperty vagy a CodeMethod tagok számára.

Ezt a paramétert a TypeName, a MemberType, az Value és a SecondValue paraméterekkel használhatja egy típus tulajdonságának vagy metódusának hozzáadásához vagy módosításához.

Ha a MemberType paraméter értéke, AliasPropertya SecondValue paraméter értékének adattípusnak kell lennie. A PowerShell az aliastulajdonság értékét a megadott típusra konvertálja (azaz leadja). Ha például olyan aliastulajdonságot ad hozzá, amely alternatív nevet ad egy sztringtulajdonságnak, megadhatja a System.Int32 SecondValue értékét is, hogy az aliasolt sztringértéket egész számmá alakítsa.

Ha a MemberType paraméter értéke az ScriptProperty, a SecondValue paraméter használatával megadhat egy további szkriptblokkot. Az Érték paraméter értékének szkriptblokkja egy változó értékét kapja meg. A SecondValue paraméter értékének szkriptblokkja beállítja a változó értékét.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Object
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SerializationDepth

Megadja, hogy a típusobjektumok hány szintje szerializálva van sztringként. Az alapértelmezett érték 1 szerializálja az objektumot és tulajdonságait. Egy érték 0 szerializálja az objektumot, de a tulajdonságait nem. Egy érték 2 szerializálja az objektumot, annak tulajdonságait és a tulajdonságértékekben szereplő összes objektumot.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	1
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SerializationMethod

A típus szerializálási módszerét adja meg. A szerializálási módszer határozza meg, hogy a típus mely tulajdonságai szerializálva vannak, és a szerializáláshoz használt technikát. A paraméter elfogadható értékei a következők:

AllPublicProperties. Szerializálja a típus összes nyilvános tulajdonságát. A SzerializálásDepth paraméter használatával meghatározhatja, hogy a gyermektulajdonságok szerializálva vannak-e.
String. Szerializálja a típust sztringként. A StringSerializationSource használatával megadhatja a szerializálási eredményként használni kívánt típusú tulajdonságot. Ellenkező esetben a típus szerializálva lesz az objektum ToString metódusával.
SpecificProperties. Csak az ilyen típusú tulajdonságok szerializálása. A PropertySerializationSet paraméter használatával adja meg a szerializált típus tulajdonságait. A InheritPropertySerializationSet paraméter használatával azt is megállapíthatja, hogy a tulajdonságkészlet öröklődik-e, a SzerializációDepth paraméter pedig meghatározza, hogy a gyermektulajdonságok szerializálva vannak-e.

A PowerShellben a szerializálási módszerek psStandardMembers belső objektumokban vannak tárolva.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-StringSerializationSource

A típus egyik tulajdonságának nevét adja meg. A szerializáció eredményeként a megadott tulajdonság értékét használja a rendszer. Ez a paraméter csak akkor érvényes, ha a SzerializálásMethod paraméter értéke Sztring.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TargetTypeForDeserialization

Azt a típust adja meg, amelybe az ilyen típusú objektum deszerializált állapotban lesz konvertálva.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Type
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TypeAdapter

Megadja a típusadapter típusát, például a Microsoft.PowerShell.Cim.CimInstanceAdapter típust. A típusadapterekkel a PowerShell lekérheti egy típus tagjait.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Type
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TypeConverter

Típuskonvertert ad meg az értékek különböző típusok közötti konvertálásához. Ha típuskonverter van definiálva egy típushoz, a rendszer a típuskonverter egy példányát használja az átalakításhoz.

Adjon meg egy System.Type értéket, amely a System.ComponentModel.TypeConverter vagy a System.Management.Automation.PSTypeConverter osztályból származik.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Type
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TypeData

A parancsmag által a munkamenethez hozzáadott adattömböt adja meg. Adjon meg egy TypeData objektumot tartalmazó változót, vagy egy TypeData-objektumot lekérő parancsot, például egy parancsotGet-TypeData. TypeData-objektumot is becsúszthat a parancsbaUpdate-TypeData.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	TypeData[]
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-TypeName

A kibővítendő típus nevét adja meg.

A rendszernévtérben lévő típusok esetén adja meg a rövid nevet. Ellenkező esetben a teljes típusnév megadása kötelező. Helyettesítő karakterek nem használhatók.

A pipe type names to Update-TypeData. Amikor egy objektumot az objektumba Update-TypeDatacsövez, Update-TypeData lekéri az objektum típusnevét, és beírja az adatokat az objektumtípusba.

Ezt a paramétert a MemberName, a MemberType, az Value és a SecondValue paraméterekkel használhatja egy típusú tulajdonság vagy metódus hozzáadásához vagy módosításához.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Value

A tulajdonság vagy metódus értékét adja meg.

Ha hozzáad egy AliasProperty, CodeProperty, vagy ScriptPropertyCodeMethod tagot, a SecondValue paraméter használatával további információkat adhat hozzá.

Ezt a paramétert a MemberName, a MemberType, az Value és a SecondValue paraméterekkel használhatja egy típusú tulajdonság vagy metódus hozzáadásához vagy módosításához.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	Object
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

String

A parancsmagra az AppendPath, TypeName vagy TypeData paraméterek értékeit tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Megosztás a következőn keresztül:

Update-TypeData

Syntax

Description

Példák

1. példa: Kiterjesztett típusok frissítése

2. példa: A típusok többszöri frissítése

3. példa: Szkripttulajdonság hozzáadása DateTime-objektumokhoz

4. példa: A listákban alapértelmezés szerint megjelenő típus frissítése

5. példa: A tulajdonság típusának beállítása széles formátumban

6. példa: Piped object típusadatainak frissítése

Paraméterek

-AppendPath

-Confirm

-DefaultDisplayProperty

-DefaultDisplayPropertySet

-DefaultKeyPropertySet

-Force

-InheritPropertySerializationSet

-MemberName

-MemberType

-PrependPath

-PropertySerializationSet

-SecondValue

-SerializationDepth

-SerializationMethod

-StringSerializationSource

-TargetTypeForDeserialization

-TypeAdapter

-TypeConverter

-TypeData

-TypeName

-Value

-WhatIf

Bevitelek

Kimenetek

További források

Megosztás a következőn keresztül:

Update-TypeData

Syntax

Description

Példák

1. példa: Kiterjesztett típusok frissítése

2. példa: A típusok többszöri frissítése

3. példa: Szkripttulajdonság hozzáadása DateTime-objektumokhoz

4. példa: A listákban alapértelmezés szerint megjelenő típus frissítése

5. példa: A tulajdonság típusának beállítása széles formátumban

6. példa: Piped object típusadatainak frissítése

Paraméterek

-AppendPath

-Confirm

-DefaultDisplayProperty

-DefaultDisplayPropertySet

-DefaultKeyPropertySet

-Force

-InheritPropertySerializationSet

-MemberName

-MemberType

-PrependPath

-PropertySerializationSet

-SecondValue

-SerializationDepth

-SerializationMethod

-StringSerializationSource

-TargetTypeForDeserialization

-TypeAdapter

-TypeConverter

-TypeData

-TypeName

-Value

-WhatIf

Bevitelek

Kimenetek

Kapcsolódó hivatkozások

További források