Update-TypeData

Reference

Modul:: Microsoft.PowerShell.Utility

Aktualizuje rozšířená data typu v relaci.

Syntaxe

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

Rutina Update-TypeData aktualizuje data rozšířeného typu v relaci opětovným načtením Types.ps1xml souborů do paměti a přidáním nových dat rozšířeného typu.

PowerShell ve výchozím nastavení načte rozšířená data typu podle potřeby. Bez parametrů Update-TypeData znovu načte všechny Types.ps1xml soubory, které se načetly v relaci, včetně všech souborů typu, které jste přidali. Parametry můžete použít k přidání souborů nového typu a přidání a nahrazení dat rozšířeného Update-TypeData typu.

Rutinu Update-TypeData lze použít k předběžnému načtení všech dat typu. Tato funkce je užitečná zejména při vývoji typů a chcete tyto nové typy načíst pro účely testování.

Počínaje windows PowerShellem 3.0 můžete v Update-TypeData relaci přidávat a nahrazovat rozšířená data typů bez použití Types.ps1xml souboru. Data typu, která se přidávají dynamicky, tj. bez souboru, se přidají pouze do aktuální relace. Pokud chcete přidat data typu do všech relací, přidejte do profilu PowerShellu Update-TypeData příkaz. Další informace najdete v tématu about_Profiles.

Počínaje windows PowerShellem 3.0 můžete také pomocí rutiny Get-TypeData získat rozšířené typy v aktuální relaci a rutinu Remove-TypeData k odstranění rozšířených typů z aktuální relace.

Výjimky, ke kterým dochází ve vlastnostech nebo při přidávání vlastností do Update-TypeData příkazu, neoznamují chyby. To je potlačení výjimek, které by se vyskytly v mnoha běžných typech při formátování a výstupu. Pokud získáváte vlastnosti rozhraní .NET, můžete místo toho obejít potlačení výjimek pomocí syntaxe metody, jak je znázorněno v následujícím příkladu:

"hello".get_Length()

Všimněte si, že syntaxi metody lze použít pouze s vlastnostmi .NET. Vlastnosti přidané spuštěním rutiny nemůžou Update-TypeData používat syntaxi metody.

Další informace o souborech v PowerShellu Types.ps1xml najdete v tématu about_Types.ps1xml.

Příklady

Příklad 1: Aktualizace rozšířených typů

Update-TypeData

Tento příkaz aktualizuje konfiguraci rozšířeného typu ze Types.ps1xml souborů, které již byly použity v relaci.

Příklad 2: Aktualizace typů několikrát

Tento příklad ukazuje, jak aktualizovat typy v souboru typu vícekrát ve stejné relaci.

První příkaz aktualizuje konfiguraci rozšířeného Types.ps1xml typu ze souborů a nejprve zpracuje TypesA.types.ps1xml soubory TypesB.types.ps1xml .

Druhý příkaz ukazuje, jak znovu aktualizovat TypesA.types.ps1xml , například pokud jste přidali nebo změnili typ souboru. Předchozí příkaz TypesA.types.ps1xml pro soubor můžete opakovat nebo spustit Update-TypeData příkaz bez parametrů, protože TypesA.types.ps1xml už je v seznamu typů pro aktuální relaci.

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

Příklad 3: Přidání vlastnosti skriptu do objektů DateTime

Tento příklad používá Update-TypeData k přidání vlastnosti skriptu čtvrtletí do objektů System.DateTime v aktuální relaci, například ty, které vrací rutina Get-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

Příkaz Update-TypeData používá parametr TypeName k určení system.DateTime typ, MemberName parametr zadat název pro novou vlastnost, MemberType vlastnost zadat Typ ScriptProperty a Value parametr zadat skript, který určuje roční čtvrtletí.

Hodnota vlastnosti Value je skript, který vypočítá aktuální roční čtvrtletí. Blok skriptu používá automatickou $this proměnnou k reprezentaci aktuální instance objektu a operátor In k určení, zda se hodnota měsíce zobrazí v každém celočíselném poli. Další informace o operátoru -in najdete v tématu about_Comparison_Operators.

Druhý příkaz získá novou vlastnost Čtvrtletí aktuálního data.

Příklad 4: Aktualizace typu, který se zobrazuje ve výchozím nastavení v seznamech

Tento příklad ukazuje, jak nastavit vlastnosti typu, který se ve výchozím nastavení zobrazuje v seznamech, to znamená, že pokud nejsou zadány žádné vlastnosti. Vzhledem k tomu, že data typu nejsou zadána v Types.ps1xml souboru, je platná pouze v aktuální relaci.

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

První příkaz zobrazí zobrazení seznamu pro Get-Date příkaz, který výstupem System.DateTime objekt, který představuje aktuální datum. Příkaz používá operátor kanálu (|) k odeslání objektu DateTime do rutiny Format-List . Format-List Protože příkaz nezadává vlastnosti, které se mají zobrazit v seznamu, PowerShell zobrazí všechny veřejné, neskrytá vlastnost objektu.

Druhý příkaz použije rutinu Update-TypeData k nastavení výchozích vlastností seznamu pro typ System.DateTime . Příkaz pomocí parametru TypeName určuje typ a DefaultDisplayPropertySet parametr k určení výchozích vlastností pro seznam. Vybrané vlastnosti zahrnují novou vlastnost skriptu čtvrtletí přidanou v předchozím příkladu.

Poslední příkaz získá aktuální datum a znovu ho zobrazí ve formátu seznamu. Zobrazí pouze vlastnosti definované v Update-TypeData příkazu místo úplného seznamu vlastností.

Příklad 5: Nastavení vlastnosti, která se zobrazí v širokém formátu

Tento příklad ukazuje, jak vytvořit novou vlastnost skriptu a použít ji jako výchozí vlastnost zobrazenou při předání typu rutině Format-Wide .

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

První příkaz pomocí rutiny Get-Command vrátí každý příkaz s názvem obsahujícím slovo File. Výstup předá rutině Format-Wide , která zobrazuje názvy příkazů ve sloupcích.

V dalším příkladu se používá k definování Update-TypeData i nové vlastnosti skriptu pro typ CommandInfo. Výstup pro Get-Command vrátí CommandInfo objekty a objekty odvozené z daného typu. Nová vlastnost skriptu FullyQualifiedName vrátí úplnou cestu ke spustitelným aplikacím a plně kvalifikovaný název rutin, který předponu názvu rutiny použije modul, který ho definuje. Rutina Update-TypeData dokáže definovat novou vlastnost skriptu a použít ji jako DefaultDisplayProperty ve stejném příkazu.

Výstup nakonec zobrazí výsledky Get-Command zobrazené v širokém formátu po aktualizaci typu. Zobrazuje plně kvalifikovaný název rutin a úplnou cestu ke spustitelným aplikacím.

Příklad 6: Aktualizace dat typu pro objekt s kanálem

$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

Tento příklad ukazuje, že když předáte objekt do Update-TypeData, Update-TypeData přidá rozšířená data typu pro typ objektu.

Tato technika je rychlejší než použití Get-Member rutiny Get-Type nebo metody k získání typu objektu. Pokud však předáte kolekci objektů Update-TypeData, aktualizuje data typu prvního typu objektu a pak vrátí chybu pro všechny ostatní objekty v kolekci, protože člen je již definován v typu.

První příkaz pomocí rutiny Get-Module získá modul Microsoft.PowerShell.Utility . Příkaz předá objekt modulu do Update-TypeData rutiny, která aktualizuje data typu System.Management.Automation.PSModuleInfo a typy odvozené z ní, například ModuleInfoGrouping typ, který Get-Module se vrátí při použití parametru ListAvailable v příkazu.

Příkazy Update-TypeData přidají vlastnost skriptu SupportsUpdatableHelp do všech importovaných modulů. Hodnota parametru Value je skript, který vrátí $true , pokud je vlastnost HelpInfoUri modulu naplněna a $false jinak.

Druhý příkaz předá objekty modulu z Get-Module rutiny Format-Table , která zobrazí vlastnosti Name a SupportsUpdatableHelp dostupných modulů.

Parametry

-AppendPath

Určuje cestu k volitelným .ps1xml souborům. Zadané soubory se načtou v pořadí, v jakém jsou uvedeny po načtení předdefinovaných souborů. Hodnotu AppendPath lze také převést na Update-TypeDatahodnotu .

Typ:	String[]
Aliasy:	PSPath, Path
Position:	0
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultDisplayProperty

Určuje vlastnost typu, který se zobrazí rutinou Format-Wide , pokud nejsou zadány žádné jiné vlastnosti.

Zadejte název standardní nebo rozšířené vlastnosti typu. Hodnota tohoto parametru může být název typu přidaného ve stejném příkazu.

Tato hodnota je efektivní pouze v případě, že pro typ v Format.ps1xml souboru nejsou definována žádná široká zobrazení.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultDisplayPropertySet

Určuje jednu nebo více vlastností typu. Tyto vlastnosti se zobrazí v Format-Listpřípadě, Format-Tableže nejsou zadány žádné jiné vlastnosti, a Format-Custom rutiny.

Zadejte názvy standardních nebo rozšířených vlastností typu. Hodnota tohoto parametru může být názvy typů, které jsou přidány ve stejném příkazu.

Tato hodnota platí pouze v případě, že pro typ v Format.ps1xml souboru nejsou definovány žádné seznamy, tabulky nebo vlastní zobrazení.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultKeyPropertySet

Určuje jednu nebo více vlastností typu. Tyto vlastnosti používají Group-Object rutiny, Sort-Object pokud nejsou zadány žádné jiné vlastnosti.

Zadejte názvy standardních nebo rozšířených vlastností typu. Hodnota tohoto parametru může být názvy typů, které jsou přidány ve stejném příkazu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Označuje, že rutina používá zadaná data typu, i když už byla pro tento typ zadána data typu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InheritPropertySerializationSet

Určuje, zda sada vlastností, které jsou serializovány je zděděna. Výchozí hodnota je $Null. Tento parametr přijímá tyto hodnoty:

$True. Sada vlastností je zděděna.
$False. Sada vlastností není zděděna.
$Null. Dědičnost není definována.

Tento parametr je platný pouze v případě, že hodnota SerializationMethod parametru je SpecificProperties. Pokud je $Falsehodnota tohoto parametru , je parametr PropertySerializationSet povinný.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MemberName

Určuje název vlastnosti nebo metody.

Tento parametr použijte s parametry TypeName, MemberType, Value a SecondValue pro přidání nebo změnu vlastnosti nebo metody typu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MemberType

Určuje typ člena, který chcete přidat nebo změnit.

Tento parametr použijte s parametry TypeName, MemberType, Value a SecondValue pro přidání nebo změnu vlastnosti nebo metody typu. Tento parametr přijímá tyto hodnoty:

AliasProperty
CodeMethod
CodeProperty
Poznámka:
SkriptMethod
ScriptProperty

Informace o těchto hodnotách naleznete v tématu PSMemberTypes – výčet.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	PSMemberTypes
Přípustné hodnoty:	NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PrependPath

Určuje cestu k volitelným .ps1xml souborům. Zadané soubory se načtou v pořadí, v jakém jsou uvedeny před načtením předdefinovaných souborů.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PropertySerializationSet

Určuje názvy vlastností, které jsou serializovány. Tento parametr použijte, pokud je hodnota SerializationMethod parametr SpecificProperties.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SecondValue

Určuje další hodnoty pro aliasProperty, ScriptProperty, CodeProperty nebo CodeMethod členy.

Tento parametr použijte s parametry TypeName, MemberType, Value a SecondValue pro přidání nebo změnu vlastnosti nebo metody typu.

Pokud je hodnota AliasProperty , hodnota parametru SecondValue musí být datový typ. PowerShell převede hodnotu vlastnosti aliasu (to znamená přetypování) na zadaný typ. Pokud například přidáte vlastnost aliasu, která poskytuje alternativní název pro vlastnost řetězce, můžete také zadat Hodnotu SecondValue system.Int32 pro převod hodnoty řetězce aliasu na celé číslo.

Pokud je hodnota Parametr MemberType , můžete použít ScriptProperty k zadání dalšího bloku skriptu. Blok skriptu v hodnotě parametru Value získá hodnotu proměnné. Blok skriptu v hodnotě parametru SecondValue nastavil hodnotu proměnné.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Object
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SerializationDepth

Určuje, kolik úrovní objektů typu jsou serializovány jako řetězce. Výchozí hodnota 1 serializuje objekt a jeho vlastnosti. Hodnota 0 serializuje objekt, ale ne jeho vlastnosti. Hodnota 2 serializuje objekt, jeho vlastnosti a všechny objekty v hodnotách vlastností.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Int32
Position:	Named
Default value:	1
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SerializationMethod

Určuje metodu serializace pro typ. Metoda serializace určuje, které vlastnosti typu jsou serializovány a technika, která se používá k jejich serializaci. Tento parametr přijímá tyto hodnoty:

AllPublicProperties. Serializovat všechny veřejné vlastnosti typu. Pomocí parametru SerializationDepth můžete určit, zda jsou podřízené vlastnosti serializovány.
String. Serializovat typ jako řetězec. StringSerializationSource můžete použít k určení vlastnosti typu, který se má použít jako výsledek serializace. V opačném případě typ je serializován pomocí ToString metoda objektu.
SpecificProperties. Serializovat pouze zadané vlastnosti tohoto typu. Pomocí PropertySerializationSet parametru zadejte vlastnosti typu, které jsou serializovány. Můžete také použít InheritPropertySerializationSet parametr určit, zda je sada vlastností zděděna a SerializationDepth parametr určit, zda podřízené vlastnosti jsou serializovány.

V PowerShellu jsou metody serializace uložené v interních objektech PSStandardMembers .

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StringSerializationSource

Určuje název vlastnosti typu. Hodnota zadané vlastnosti se používá jako výsledek serializace. Tento parametr je platný pouze v případě, že hodnota SerializationMethod parametru je String.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TargetTypeForDeserialization

Určuje typ, na který objekt tohoto typu je převeden při deserializaci.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Type
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TypeAdapter

Určuje typ adaptéru typu, například Microsoft.PowerShell.Cim.CimInstanceAdapter. Adaptér typu umožňuje PowerShellu získat členy typu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Type
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TypeConverter

Určuje převaděč typů pro převod hodnot mezi různými typy. Pokud je pro typ definován převaděč typů, použije se pro převod instance převaděče typů.

Zadejte hodnotu System.Type odvozenou z třídy System.ComponentModel.TypeConverter nebo System.Management.Automation.PSTypeConverter.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Type
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TypeData

Určuje pole dat typu, která tato rutina přidá do relace. Zadejte proměnnou obsahující objekt TypeData nebo příkaz, který získá objekt TypeData , například Get-TypeData příkaz. Objekt TypeData můžete také převést na Update-TypeData.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	TypeData[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-TypeName

Určuje název typu, který se má rozšířit.

Pro typy v oboru názvů systému zadejte krátký název. V opačném případě se vyžaduje úplný název typu. Zástupné znaky se nepodporují.

Názvy typů svislých razítek můžete zadat do Update-TypeData. Když předáte objekt Update-TypeDatado , Update-TypeData získá název typu objektu a typ dat do typu objektu.

Tento parametr použijte s parametry MemberName, MemberType, Value a SecondValue pro přidání nebo změnu vlastnosti nebo metody typu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Value

Určuje hodnotu vlastnosti nebo metody.

Pokud přidáte parametr AliasProperty, CodeProperty, ScriptPropertynebo CodeMethod člen, můžete pomocí parametru SecondValue přidat další informace.

Tento parametr použijte s parametry MemberName, MemberType, Value a SecondValue pro přidání nebo změnu vlastnosti nebo metody typu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Object
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

Do této rutiny můžete převést řetězec obsahující hodnoty parametrů AppendPath, TypeName nebo TypeData .

Výstupy

None

Tato rutina nevrátí žádný výstup.

Sdílet prostřednictvím

Update-TypeData

Syntaxe

Description

Příklady

Příklad 1: Aktualizace rozšířených typů

Příklad 2: Aktualizace typů několikrát

Příklad 3: Přidání vlastnosti skriptu do objektů DateTime

Příklad 4: Aktualizace typu, který se zobrazuje ve výchozím nastavení v seznamech

Příklad 5: Nastavení vlastnosti, která se zobrazí v širokém formátu

Příklad 6: Aktualizace dat typu pro objekt s kanálem

Parametry

-AppendPath

-Confirm

-DefaultDisplayProperty

-DefaultDisplayPropertySet

-DefaultKeyPropertySet

-Force

-InheritPropertySerializationSet

-MemberName

-MemberType

-PrependPath

-PropertySerializationSet

-SecondValue

-SerializationDepth

-SerializationMethod

-StringSerializationSource

-TargetTypeForDeserialization

-TypeAdapter

-TypeConverter

-TypeData

-TypeName

-Value

-WhatIf

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Update-TypeData

Syntaxe

Description

Příklady

Příklad 1: Aktualizace rozšířených typů

Příklad 2: Aktualizace typů několikrát

Příklad 3: Přidání vlastnosti skriptu do objektů DateTime

Příklad 4: Aktualizace typu, který se zobrazuje ve výchozím nastavení v seznamech

Příklad 5: Nastavení vlastnosti, která se zobrazí v širokém formátu

Příklad 6: Aktualizace dat typu pro objekt s kanálem

Parametry

-AppendPath

-Confirm

-DefaultDisplayProperty

-DefaultDisplayPropertySet

-DefaultKeyPropertySet

-Force

-InheritPropertySerializationSet

-MemberName

-MemberType

-PrependPath

-PropertySerializationSet

-SecondValue

-SerializationDepth

-SerializationMethod

-StringSerializationSource

-TargetTypeForDeserialization

-TypeAdapter

-TypeConverter

-TypeData

-TypeName

-Value

-WhatIf

Vstupy

Výstupy

Související odkazy

Další materiály