Delen via

Remove-TypeData

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u uitgebreide typen uit de huidige sessie.

Syntaxis

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

Description

Met de Remove-TypeData cmdlet worden uitgebreide typegegevens uit de huidige sessie verwijderd. 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 u eventuele uitgebreide typedefinities uit de Types.ps1xml bestanden. Zie about_Types.ps1xmlvoor 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 System.Array type verwijderd uit de sessie, 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 krijgt uitgebreide typegegevens voor het System.DateTime- type. In de uitvoer ziet u dat een eigenschap DateTime is toegevoegd aan alle System.DateTime--objecten in PowerShell. De cmdlet Get-Date retourneert een System.DateTime--object. De opdracht gebruikt puntnotatie om de waarde op te halen van de eigenschap DateTime van het System.DateTime--object 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 System.DateTime type en pijpen die naar de Remove-TypeData cmdlet om de uitgebreide typegegevens te verwijderen. De laatste Get-Date cmdlet toont het effect van het verwijderen van de uitgebreide typegegevens voor het System.DateTime type. Omdat de eigenschap System.DateTime niet meer bestaat, retourneert een opdracht om de waarde ervan 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 naar Remove-TypeData, haalt Remove-TypeData 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 cmdlet Remove-TypeData 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 cmdlet Update-TypeData. 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_Modulesvoor 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

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 doorspezen naar Remove-TypeData.

Type:TypeData
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 typnamen doorsluisen naar Remove-TypeData. Wanneer u een object doorsluist naar Remove-TypeData, haalt Remove-TypeData de typenaam van het object op en verwijdert u alle typegegevens voor het objecttype.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

TypeData

U kunt een TypeData--object, zoals het object dat de Get-TypeData cmdlet retourneert, 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.