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
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                                      Block-FileShareAccess
Clear-FileStorageTier                                      Close-SmbOpenFile
Debug-FileShare                                            Disable-NetIPHttpsProfile
Enable-NetIPHttpsProfile                                   Get-FileHash
Get-FileIntegrity                                          Get-FileShare
Get-FileShareAccessControlEntry                            Get-FileStorageTier
Get-NetConnectionProfile                                   Get-NetFirewallHyperVProfile
Get-NetFirewallProfile                                     Get-SmbOpenFile
Get-StorageFileServer                                      Get-SupportedFileSystems
Grant-FileShareAccess                                      Import-PowerShellDataFile
New-FileShare                                              New-NetFirewallHyperVProfile
New-ScriptFileInfo                                         New-StorageFileServer
New-TemporaryFile                                          Publish-BCFileContent
Remove-FileShare                                           Remove-NetFirewallHyperVProfile
Remove-StorageFileServer                                   Repair-FileIntegrity
Revoke-FileShareAccess                                     Set-FileIntegrity
Set-FileShare                                              Set-FileStorageTier
Set-NetConnectionProfile                                   Set-NetFirewallHyperVProfile
Set-NetFirewallProfile                                     Set-StorageBusProfile
Set-StorageFileServer                                      Test-ScriptFileInfo
Unblock-FileShareAccess                                    Update-ScriptFileInfo
Add-BitsFile                                               Get-AIPFileStatus
Get-AppLockerFileInformation                               New-FileCatalog
New-PSRoleCapabilityFile                                   New-PSSessionConfigurationFile
Out-File                                                   Set-AIPFileClassification
Set-AIPFileLabel                                           Set-AppXProvisionedDataFile
Set-UevTemplateProfile                                     Test-FileCatalog
Test-PSSessionConfigurationFile                            Unblock-File
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                      Storage\Block-FileShareAccess
Storage\Clear-FileStorageTier                              SmbShare\Close-SmbOpenFile
Storage\Debug-FileShare                                    NetworkTransition\Disable-NetIPHttpsProfile
NetworkTransition\Enable-NetIPHttpsProfile                 Microsoft.PowerShell.Utility\Get-FileHash
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                              Microsoft.PowerShell.Utility\Import-PowerShellDataFile
Storage\New-FileShare                                      NetSecurity\New-NetFirewallHyperVProfile
PowerShellGet\New-ScriptFileInfo                           Storage\New-StorageFileServer
Microsoft.PowerShell.Utility\New-TemporaryFile             BranchCache\Publish-BCFileContent
Storage\Remove-FileShare                                   NetSecurity\Remove-NetFirewallHyperVProfile
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
Storage\Unblock-FileShareAccess                            PowerShellGet\Update-ScriptFileInfo
BitsTransfer\Add-BitsFile                                  AzureInformationProtection\Get-AIPFileStatus
AppLocker\Get-AppLockerFileInformation                     Microsoft.PowerShell.Security\New-FileCatalog
Microsoft.PowerShell.Core\New-PSRoleCapabilityFile         Microsoft.PowerShell.Core\New-PSSessionConfigurationFile
Microsoft.PowerShell.Utility\Out-File                      AzureInformationProtection\Set-AIPFileClassification
AzureInformationProtection\Set-AIPFileLabel                Dism\Set-AppXProvisionedDataFile
UEV\Set-UevTemplateProfile                                 Microsoft.PowerShell.Security\Test-FileCatalog
Microsoft.PowerShell.Core\Test-PSSessionConfigurationFile  Microsoft.PowerShell.Utility\Unblock-File
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í DefaultDisplayProperty i nové vlastnosti skriptu pro typ CommandInfo.Update-TypeData 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.Operation.Validation                  True
Microsoft.PowerShell.Archive                               True
Microsoft.PowerShell.Diagnostics                           True
Microsoft.PowerShell.Host                                  True
Microsoft.PowerShell.LocalAccounts                         True
Microsoft.PowerShell.Management                            True
Microsoft.PowerShell.ODataUtils                            True
Microsoft.PowerShell.Security                              True
Microsoft.PowerShell.Utility                               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 AliasPropertyhodnota parametru MemberType , 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 Parametr SecondValue k zadání dalšího bloku ScriptPropertyskriptu. 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