Remove-TypeData

  • Referens
Modul:
Microsoft.PowerShell.Utility

Tar bort utökade typer från den aktuella sessionen.

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

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Anger en matris med filer som den här cmdleten tar bort från sessionens utökade typdata. Den här parametern krävs.

Ange sökvägar och filnamn för en eller flera Types.ps1xml filer. Jokertecken stöds inte. Om du utelämnar sökvägen är standardplatsen den aktuella katalogen.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TypeData

Anger de typdata som den här cmdleten tar bort från sessionen. Den här parametern krävs. Ange en variabel som innehåller TypeData-objekt (System.Management.Automation.Runspaces.TypeData) eller ett kommando som hämtar TypeData-objekt, till exempel ett Get-TypeData kommando. Du kan också skicka TypeData-objekt till Remove-TypeData.

Type:TypeData
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TypeName

Anger de typer som den här cmdleten tar bort alla utökade typdata för. För typer i systemnamnområdet anger du det korta namnet. Annars krävs det fullständiga typnamnet. Jokertecken stöds inte.

Du kan ange namn på pipe-typ till Remove-TypeData. När du flyttar ett objekt till Remove-TypeDataRemove-TypeData hämtar du typnamnet för objektet och tar bort alla typdata för objekttypen.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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.