Remove-TypeData

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

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

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

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 utökad typ från Types.ps1xml-filerna. Mer information om Types.ps1xml filer finns i about_Types.ps1xml.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Det här exemplet tar bort alla typdata för System.Array typ 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

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 System.DateTime typ. 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 egenskapen DateTime för System.DateTime objekt som Get-Date returnerar.

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 typ 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 System.DateTime typ. Eftersom egenskapen System.DateTime inte längre finns returnerar ett kommando för att hämta dess värde ingenting.

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

Get-Module | Remove-TypeData

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 Types.ps1xml filer som läggs till av PSScheduledJob- och PSWorkflow- moduler. 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.

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}

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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.

Den här cmdleten returnerar inga utdata.

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.