Remove-TypeData
Odstraní rozšířené typy z aktuální relace.
Syntaxe
RemoveTypeDataSet (Výchozí)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Remove-TypeData odstraní data rozšířeného typu z aktuální relace. Tato rutina ovlivňuje pouze aktuální relaci a relace vytvořené v aktuální relaci.
Do objektů v PowerShellu můžete přidat vlastnosti a metody tak, že je definujete v Update-TypeData příkazech a Types.ps1xml souborech.
Remove-TypeData tyto rozšířené vlastnosti a metody odstraní z aktuální relace.
Remove-TypeData neodstraní soubory Types.ps1xml ani neodstraní žádné definice rozšířeného typu ze souborů Types.ps1xml. Další informace o Types.ps1xml soubory naleznete v tématu about_Types.ps1xml.
Tato rutina byla zavedena ve Windows PowerShellu 3.0.
Příklady
Příklad 1: Odebrání dat typu pro zadaný typ
Tento příklad odstraní všechna data typu pro typ System.Array z relace, včetně dat typu, která byla přidána Types.ps1xml souborem a dynamickým typem dat, která byla přidána do relace pomocí rutiny Update-TypeData.
Remove-TypeData -TypeName System.Array
Příklad 2: Odebrání rozšířeného datového typu z relace
Tento příklad ukazuje účinek odebrání rozšířených dat typu z relace. První Get-TypeData získá rozšířená data o typu System.DateTime. Výstup ukazuje, že vlastnost DateTime byla přidána do všech objektů System.DateTime v PowerShellu. Rutina Get-Date vrátí objekt System.DateTime. Příkaz používá tečku k získání hodnoty DateTime vlastnost System.DateTime objekt, který Get-Date vrátí.
Get-TypeData System.DateTime
(Get-Date).DateTime
Get-TypeData System.DateTime | Remove-TypeData
(Get-Date).DateTime
TypeName Members
-------- -------
System.DateTime {[DateTime, System.Management.Automation.Runspaces.ScriptPropertyData]}
Friday, January 20, 2012 9:01:00 PM
Další Get-TypeData rutina, která získá všechna rozšířená data o typu System.DateTime a kanály, které do rutiny Remove-TypeData odstraní data rozšířeného typu. Poslední rutina Get-Date ukazuje účinek odstranění rozšířených dat typu pro typ System.DateTime. Vzhledem k tomu, že vlastnost System.DateTime již neexistuje, příkaz, který získá jeho hodnotu, nevrátí nic.
Příklad 3: Odebrání rozšířených typů pro moduly
Tento příklad odebere všechna rozšířená data typu pro objekty modulu. Když předáte objekt do Remove-TypeData, Remove-TypeData získá název typu objektu a odebere všechna data typu pro všechny objekty daného typu.
Get-Module | Remove-TypeData
Příklad 4: Odebrání rozšířených typů ze zadaných modulů
Tento příklad používá parametr path rutiny Remove-TypeData k odebrání rozšířených typů definovaných v souborech Types.ps1xml, které jsou přidány moduly PSScheduledJob a PSWorkflow. Tento příkaz nemá vliv na data dynamického typu přidaná pomocí rutiny Update-TypeData. Příkaz bude úspěšný pouze v případech, kdy byly moduly importovány do aktuální relace.
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
Další informace o modulech najdete v about_Modules.
Příklad 5: Odebrání rozšířených typů ze vzdálené relace
Tento příklad odebere rozšířené typy ze vzdálené relace. Příkaz používá rutinu Invoke-Command k odebrání rozšířených dat typu pro všechny typy CIM v relacích v proměnné $S.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Parametry
-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 |
-Path
Určuje pole souborů, které tato rutina odstraní z dat rozšířeného typu relace. Tento parametr je povinný.
Zadejte cesty a názvy souborů jednoho nebo více Types.ps1xml souborů. Zástupné dokumentace nejsou podporovány. Pokud tuto cestu vynecháte, výchozí umístění je aktuální adresář.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
RemoveFileSet
| Position: | Named |
| Povinné: | True |
| 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 data typu, která tato rutina odstraní z relace. Tento parametr je povinný. Zadejte proměnnou, která obsahuje objekty TypeData (System.Management.Automation.Runspaces.TypeData) nebo příkaz, který získá objekty TypeData, například příkaz Get-TypeData. Můžete také TypeData objekty Remove-TypeData.
Vlastnosti parametru
| Typ: | TypeData |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
RemoveTypeDataSet
| 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 |
-TypeName
Určuje typy, pro které tato rutina odstraní všechna rozšířená data typu. 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é dokumentace nejsou podporovány.
Názvy typů svislých razítek můžete Remove-TypeData. Když předáte objekt do Remove-TypeData, Remove-TypeData získá název typu objektu a odebere všechna data typu pro typ objektu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
RemoveTypeSet
| 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 |
-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
TypeData
Do této rutiny můžete typeData objektu, například objekty, které Get-TypeData rutina vrací.
String
Do této rutiny můžete zamísťovat řetězec obsahující název typu. Když objekt předáte do této rutiny, získá název typu objektu a odebere všechna data typu objektu.
Výstupy
None
Tento cmdlet nevrátí žádný výstup.
Poznámky
Remove-TypeData může v aktuální relaci odebrat pouze data rozšířeného typu. Nelze odebrat rozšířená data typu, která jsou v počítači, ale nebyla přidána do aktuální relace, například rozšířené typy definované v modulech, které nebyly importovány do aktuální relace.
