Sdílet prostřednictvím

Remove-TypeData

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odstraní rozšířené typy z aktuální relace.

Syntaxe

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      [-TypeName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 omodule about_Moduleschch

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 rutiny vás vyzve 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

-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ář.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:TypeData
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

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

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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

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

Tato rutina 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.