Remove-TypeData

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u uitgebreide typen uit de huidige sessie.

Syntax

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

Description

De Remove-TypeData cmdlet verwijdert uitgebreide typegegevens uit de huidige sessie. Deze cmdlet is alleen van invloed op de huidige sessie en sessies die zijn gemaakt in de huidige sessie.

U kunt eigenschappen en methoden toevoegen aan objecten in PowerShell door ze te definiëren in Update-TypeData opdrachten en Types.ps1xml bestanden. Remove-TypeData verwijdert deze uitgebreide eigenschappen en methoden uit de huidige sessie. Remove-TypeData verwijdert de Types.ps1xml bestanden niet of verwijdert geen uitgebreide typedefinities uit de Types.ps1xml bestanden. Zie about_Types.ps1xml voor meer informatie over Types.ps1xml bestanden.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: Typegegevens voor een opgegeven type verwijderen

In dit voorbeeld worden alle typegegevens voor het type System.Array uit de sessie verwijderd, inclusief typegegevens die zijn toegevoegd door een Types.ps1xml bestand en dynamische typegegevens die aan de sessie zijn toegevoegd met behulp van de Update-TypeData cmdlet.

Remove-TypeData -TypeName System.Array

Voorbeeld 2: Een uitgebreid gegevenstype uit een sessie verwijderen

In dit voorbeeld ziet u het effect van het verwijderen van uitgebreide typegegevens uit een sessie. De eerste Get-TypeData haalt uitgebreide typegegevens op voor het type System.DateTime . In de uitvoer ziet u dat een eigenschap DateTime is toegevoegd aan alle System.DateTime-objecten in PowerShell. De Get-Date cmdlet retourneert een System.DateTime-object . De opdracht maakt gebruik van puntnotatie om de waarde op te halen van de eigenschap DateTime van het object System.DateTime dat Get-Date retourneert.

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

De volgende Get-TypeData cmdlet om alle uitgebreide typegegevens op te halen voor het type System.DateTime en pijpen die naar de Remove-TypeData cmdlet worden verzonden om de uitgebreide typegegevens te verwijderen. De laatste Get-Date cmdlet toont het effect van het verwijderen van de uitgebreide typegegevens voor het type System.DateTime . Omdat de eigenschap System.DateTime niet meer bestaat, retourneert een opdracht om de waarde op te halen niets.

Voorbeeld 3: Uitgebreide typen voor modules verwijderen

In dit voorbeeld worden alle uitgebreide typegegevens voor moduleobjecten verwijderd. Wanneer u een object doorsluist Remove-TypeData, Remove-TypeData haalt u de naam van het objecttype op en verwijdert u alle typegegevens voor alle objecten van dat type.

Get-Module | Remove-TypeData

Voorbeeld 4: Uitgebreide typen verwijderen uit opgegeven modules

In dit voorbeeld wordt de parameter Path van de Remove-TypeData cmdlet gebruikt om de uitgebreide typen te verwijderen die zijn gedefinieerd in de Types.ps1xml bestanden die worden toegevoegd door de PSScheduledJob - en PSWorkflow-modules . Deze opdracht heeft geen invloed op dynamische typegegevens die worden toegevoegd met behulp van de Update-TypeData cmdlet. De opdracht slaagt alleen wanneer de modules zijn geïmporteerd in de huidige sessie.

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

Zie about_Modules voor meer informatie over modules.

Voorbeeld 5: Uitgebreide typen verwijderen uit een externe sessie

In dit voorbeeld worden uitgebreide typen uit een externe sessie verwijderd. De opdracht gebruikt de Invoke-Command cmdlet om uitgebreide typegegevens te verwijderen voor alle CIM-typen in de sessies in de $S variabele.

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

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Path

Hiermee geeft u een matrix van bestanden op die met deze cmdlet worden verwijderd uit de gegevens van het uitgebreide sessietype. Deze parameter is vereist.

Voer de paden en bestandsnamen van een of meer Types.ps1xml bestanden in. Jokertekens worden niet ondersteund. Als u het pad weglaat, is de standaardlocatie de huidige map.

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

-TypeData

Hiermee geeft u de typegegevens op die door deze cmdlet uit de sessie worden verwijderd. Deze parameter is vereist. Voer een variabele in die TypeData-objecten bevat (System.Management.Automation.Runspaces.TypeData) of een opdracht waarmee TypeData-objecten worden opgehaald, zoals een Get-TypeData opdracht. U kunt ook TypeData-objecten doorsluisen naar Remove-TypeData.

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

-TypeName

Hiermee geeft u de typen op waarvoor deze cmdlet alle uitgebreide typegegevens verwijdert. Voer de korte naam in voor typen in de systeemnaamruimte. Anders is de volledige typenaam vereist. Jokertekens worden niet ondersteund.

U kunt namen van sluistekens sluistekens naar Remove-TypeData. Wanneer u een object doorsluist Remove-TypeData, Remove-TypeData haalt u de typenaam van het object op en verwijdert u alle typegegevens voor het objecttype.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

TypeData

U kunt een TypeData-object , zoals het object dat door de Get-TypeData cmdlet wordt geretourneerd, doorsturen naar deze cmdlet.

String

U kunt een tekenreeks met de typenaam doorsluisen naar deze cmdlet. Wanneer u een object doorgeeft aan deze cmdlet, wordt de typenaam van het object opgehaald en worden alle typegegevens voor het objecttype verwijderd.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Remove-TypeData kan alleen de uitgebreide typegegevens in de huidige sessie verwijderen. Het kan geen uitgebreide typegegevens verwijderen die zich op de computer bevinden, maar is niet toegevoegd aan de huidige sessie, zoals uitgebreide typen die zijn gedefinieerd in modules die niet zijn geïmporteerd in de huidige sessie.