Update-TypeData
Aktualizuje rozšířená data typu v relaci.
Syntax
FileSet (Výchozí)
Update-TypeData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DynamicTypeSet
Update-TypeData
-TypeName <String>
[-MemberType <PSMemberTypes>]
[-MemberName <String>]
[-Value <Object>]
[-SecondValue <Object>]
[-TypeConverter <Type>]
[-TypeAdapter <Type>]
[-SerializationMethod <String>]
[-TargetTypeForDeserialization <Type>]
[-SerializationDepth <Int32>]
[-DefaultDisplayProperty <String>]
[-InheritPropertySerializationSet <Nullable`1>]
[-StringSerializationSource <String>]
[-DefaultDisplayPropertySet <String[]>]
[-DefaultKeyPropertySet <String[]>]
[-PropertySerializationSet <String[]>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
TypeDataSet
Update-TypeData
[-TypeData] <TypeData[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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 přidaných typů souborů. Parametry Update-TypeData můžete použít k přidání souborů nového typu a přidání a nahrazení dat rozšířeného 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 pomocí Update-TypeData přidat a nahradit data rozšířeného typu v relaci bez použití souboru Types.ps1xml. 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 příkaz Update-TypeData. 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 příkazu Update-TypeData, 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 Update-TypeData nemůžou používat syntaxi metody.
Další informace o souborech Types.ps1xml v PowerShellu 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 z 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 typu ze souborů Types.ps1xml, nejprve zpracuje TypesA.types.ps1xml a TypesB.types.ps1xml soubory.
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 můžete opakovat pro soubor TypesA.types.ps1xml nebo spustit příkaz Update-TypeData 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 Quarter do System.DateTime objekty v aktuální relaci, například objekty vrácené rutinou 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í typ System.DateTime, parametr MemberName zadat název nové vlastnosti, vlastnost MemberType zadat typ ScriptProperty a parametr Hodnota 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á $this automatickou 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 naleznete v části 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 souboru Types.ps1xml, platí 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 příkaz Get-Date, který vypíše objekt System.DateTime, který představuje aktuální datum. Příkaz pomocí operátoru kanálu (|) odešle objekt DateTime do rutiny Format-List. Vzhledem k tomu, že příkaz Format-List nezadává vlastnosti, které se mají v seznamu zobrazit, PowerShell zobrazí všechny veřejné, neskrytá vlastnost objektu.
Druhý příkaz používá rutinu Update-TypeData k nastavení výchozích vlastností seznamu pro typ System.Date Time. Příkaz pomocí parametru TypeName určuje typ a DefaultDisplayPropertySet parametr k určení výchozích vlastností seznamu. Vybrané vlastnosti zahrnují novou vlastnost skriptu Quarter, která byla přidána 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 příkazu Update-TypeData 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 do rutiny 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 používá rutinu Get-Command k vrácení každého příkazu s názvem obsahujícím slovo File. Výstup předá rutině Format-Wide, která zobrazuje názvy příkazů ve sloupcích.
Dále příklad používá Update-TypeData definovat DefaultDisplayProperty a novou vlastnost 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 pomocí modulu, 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 nebo metody Get-Type k získání typu objektu. Pokud však předáte kolekci objektů do 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 používá rutinu Get-Module k získání modulu Microsoft.PowerShell.Utility.
Příkaz předá objekt modulu do rutiny Update-TypeData, která aktualizuje typová data pro System.Management.Automation.PSModuleInfo typ a typy odvozené, například ModuleInfoGrouping typ, který Get-Module vrátí, když v příkazu použijete parametr ListAvailable.
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 do rutiny Format-Table, která zobrazí Name a SupportsUpdatableHelp vlastnosti dostupných modulů.
Parametry
-AppendPath
Určuje cestu k volitelným souborům .ps1xml. Zadané soubory se načtou v pořadí, v jakém jsou uvedeny po načtení předdefinovaných souborů. Do můžete také Update-TypeData AppendPath.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, Cesta |
Sady parametrů
FileSet
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 souboru Format.ps1xml nejsou definována žádná široká zobrazení.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DefaultDisplayPropertySet
Určuje jednu nebo více vlastností typu. Tyto vlastnosti jsou zobrazeny rutinami Format-List, Format-Tablea Format-Custom, 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.
Tato hodnota platí pouze v případě, že pro typ v souboru Format.ps1xml nejsou definovány žádné seznamy, tabulky nebo vlastní zobrazení.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DefaultKeyPropertySet
Určuje jednu nebo více vlastností typu. Tyto vlastnosti používají rutiny Group-Object a 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
TypeDataSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InheritPropertySerializationSet
Určuje, zda sada vlastností, které jsou serializovány je zděděna. Výchozí hodnota je $null. Přijatelné hodnoty pro tento parametr jsou:
-
$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 parametru SerializationMethod je SpecificProperties. Pokud je hodnota tohoto parametru $false, je vyžadován parametr PropertySerializationSet.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MemberName
Určuje název vlastnosti nebo metody.
Tento parametr použijte s parametry TypeName, MemberType, Value a SecondValue parametry pro přidání nebo změnu vlastnosti nebo metody typu.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MemberType
Určuje typ člena, který chcete přidat nebo změnit.
Tento parametr použijte s parametry TypeName, MemberType, Value a SecondValue parametry pro přidání nebo změnu vlastnosti nebo metody typu. Přijatelné hodnoty pro tento parametr jsou:
- AliasProperty
- CodeMethod
- CodeProperty
- Poznámka:
- SkriptMetoda
- ScriptProperty
Informace o těchto hodnotách naleznete v tématu PSMemberTypes Výčet.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | PSMemberTypes |
| Default value: | None |
| Přípustné hodnoty: | NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PrependPath
Určuje cestu k volitelným souborům .ps1xml. Zadané soubory se načtou v pořadí, v jakém jsou uvedeny před načtením předdefinovaných souborů.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
FileSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PropertySerializationSet
Určuje názvy vlastností, které jsou serializovány. Tento parametr použijte, pokud je hodnota parametru SerializationMethodSpecificProperties.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SecondValue
Určuje další hodnoty pro AliasProperty, ScriptProperty, CodePropertynebo CodeMethod členy.
Tento parametr použijte s parametry TypeName, MemberType, Valuea SecondValue parametry pro přidání nebo změnu vlastnosti nebo metody typu.
Pokud je hodnota parametru MemberTypeAliasProperty, 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 vlastnosti řetězce, můžete také zadat SecondValueSystem.Int32 převést hodnotu aliasovaného řetězce na celé číslo.
Pokud je hodnota parametru MemberTypeScriptProperty, můžete k zadání dalšího bloku skriptu použít parametr SecondValue. Blok skriptu v hodnotě Value parametr získá hodnotu proměnné. Blok skriptu v hodnotě SecondValue parametru nastavil hodnotu proměnné.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | Object |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | 1 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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. Přijatelné hodnoty pro tento parametr jsou:
-
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. Pomocí StringSerializationSource můžete zadat vlastnost 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í parametru PropertySerializationSet 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ženy v PSStandardMembers interní objekty.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 String.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | Type |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | Type |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 od System.ComponentModel.TypeConverter nebo System.Management.Automation.PSTypeConverter tříd.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | Type |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-TypeData
Určuje pole dat typu, která tato rutina přidá do relace. Zadejte proměnnou, která obsahuje objekt TypeData nebo příkaz, který získá objekt TypeData, například příkaz Get-TypeData. Objekt typeData můžete takéUpdate-TypeData.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | TypeData[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
TypeDataSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-TypeName
Určuje název typu, který se má rozšířit.
Pro typy v oboru názvů System zadejte krátký název. V opačném případě se vyžaduje úplný název typu. Zástupné dokumentace nejsou podporovány.
Názvy typů svislých razítek můžete Update-TypeData. Když předáte objekt do Update-TypeData, 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 parametry pro přidání nebo změnu vlastnosti nebo metody typu.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Value
Určuje hodnotu vlastnosti nebo metody.
Pokud přidáte AliasProperty, CodeProperty, ScriptPropertynebo CodeMethod člena, můžete k přidání dalších informací použít parametr SecondValue.
Tento parametr použijte s parametry MemberName, MemberType, Value a SecondValue parametry pro přidání nebo změnu vlastnosti nebo metody typu.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | Object |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DynamicTypeSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje hodnoty AppendPath, TypeNamenebo Parametrů TypeData do této rutiny, můžete ho přeskakovat.
Výstupy
None
Tento cmdlet nevrátí žádný výstup.
