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 odstraní tyto rozšířené vlastnosti a metody z aktuální relace. Remove-TypeData neodstraní soubory ani neodstraní Types.ps1xml žádné definice rozšířeného Types.ps1xml typu ze souborů. Další informace o Types.ps1xml souborech najdete 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 typů pro typ System.Array z relace, včetně dat typu, která byla přidána souborem Types.ps1xml 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 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 objektu, který Get-Date vrací.

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 pro získání všech dat rozšířeného typu pro typ System.DateTime a kanály, které rutině Remove-TypeData odstraní data rozšířeného typu. Poslední Get-Date rutina ukazuje účinek odstranění dat rozšířeného typu pro typ System.DateTime . Protože vlastnost System.DateTime již neexistuje, příkaz k získání jeho hodnoty 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 Remove-TypeDatado , 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 k odebrání rozšířených Remove-TypeData typů definovaných v Types.ps1xml souborech, 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 tématu 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 pomocí rutiny Invoke-Command odebere rozšířená data typu pro všechny typy CIM v relacích v $S proměnné.

Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}

Parametry

-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

-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é znaky se nepodporují. 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 Get-TypeData příkaz. Objekty TypeData můžete také pipetovat na 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é znaky se nepodporují.

Názvy typů svislých razítek můžete zadat do Remove-TypeData. Když předáte objekt Remove-TypeDatado , 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

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

TypeData

Do této rutiny můžete převést objekt TypeData , například objekty, které rutina Get-TypeData 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 odebrat pouze rozšířená data typu v aktuální relaci. 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.