Remove-TypeData

Syntax

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-TypeData
      [-TypeName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-TypeData
      -Path <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Remove-TypeData tar bort utökade typdata från den aktuella sessionen. Den här cmdleten påverkar endast den aktuella sessionen och sessioner som skapas i den aktuella sessionen.

Du kan lägga till egenskaper och metoder i objekt i PowerShell genom att definiera dem i Update-TypeData kommandon och Types.ps1xml filer. Remove-TypeData tar bort de utökade egenskaperna och metoderna från den aktuella sessionen. Remove-TypeData tar inte bort Types.ps1xml filerna eller tar bort eventuella definitioner av Types.ps1xml utökad typ från filerna. Mer information om Types.ps1xml filer finns i about_Types.ps1xml.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Ta bort typdata för en angiven typ

Det här exemplet tar bort alla typdata för typen System.Array från sessionen, inklusive typdata som lades till av en Types.ps1xml fil och dynamiska typdata som lades till i sessionen med hjälp av cmdleten Update-TypeData .

Remove-TypeData -TypeName System.Array

Exempel 2: Ta bort en utökad datatyp från en session

Det här exemplet visar effekten av att ta bort utökade typdata från en session. Den första Get-TypeData hämtar utökade typdata för typen System.DateTime . Utdata visar att en DateTime-egenskap har lagts till i alla System.DateTime-objekt i PowerShell. Cmdleten Get-Date returnerar ett System.DateTime-objekt . Kommandot använder punkt notation för att hämta värdet för datetime-egenskapen för objektet System.DateTime som Get-Date returneras.

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

Nästa Get-TypeData cmdlet för att hämta alla utökade typdata för System.DateTime-typen och rör som till cmdleten Remove-TypeData för att ta bort utökade typdata. Den sista Get-Date cmdleten visar effekten av att ta bort utökade typdata för typen System.DateTime . Eftersom egenskapen System.DateTime inte längre finns returnerar ett kommando för att hämta dess värde ingenting.

Exempel 3: Ta bort utökade typer för moduler

Det här exemplet tar bort alla utökade typdata för modulobjekt. När du flyttar ett objekt till Remove-TypeDataRemove-TypeData hämtar du namnet på objekttypen och tar bort alla typdata för alla objekt av den typen.

Get-Module | Remove-TypeData

Exempel 4: Ta bort utökade typer från angivna moduler

I det här exemplet används parametern Path för cmdleten Remove-TypeData för att ta bort de utökade typer som definieras i filerna Types.ps1xml som läggs till av modulerna PSScheduledJob och PSWorkflow . Det här kommandot påverkar inte dynamiska typdata som läggs till med hjälp av cmdleten Update-TypeData . Kommandot lyckas bara när modulerna har importerats till den aktuella sessionen.

Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"

Mer information om moduler finns i about_Modules.

Exempel 5: Ta bort utökade typer från en fjärrsession

Det här exemplet tar bort utökade typer från en fjärrsession. Kommandot använder cmdleten Invoke-Command för att ta bort utökade typdata för alla CIM-typer i sessionerna i variabeln $S .

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

Parametrar

-Confirm

-Path

-TypeData

-TypeName

-WhatIf

Indata

TypeData

Du kan skicka ett TypeData-objekt , till exempel de som cmdleten Get-TypeData returnerar, till den här cmdleten.

String

Du kan skicka en sträng som innehåller typnamnet till den här cmdleten. När du dirigerar ett objekt till den här cmdleten hämtar det typnamnet för objektet och tar bort alla typdata för objekttypen.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Remove-TypeData kan bara ta bort utökade typdata i den aktuella sessionen. Det går inte att ta bort utökade typdata som finns på datorn, men som inte har lagts till i den aktuella sessionen, till exempel utökade typer som definieras i moduler som inte har importerats till den aktuella sessionen.

Relaterade länkar

• Get-TypeData
• Update-TypeData