Freigeben über

Remove-TypeData

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Löscht erweiterte Typen aus der aktuellen Sitzung.

Syntax

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

Beschreibung

Das Cmdlet Remove-TypeData löscht erweiterte Typdaten aus der aktuellen Sitzung. Dieses Cmdlet betrifft nur die aktuelle Sitzung und Sitzungen, die in der aktuellen Sitzung erstellt werden.

Sie können Objekten in PowerShell Eigenschaften und Methoden hinzufügen, indem Sie sie in Update-TypeData Befehlen und Types.ps1xml Dateien definieren. Remove-TypeData löscht diese erweiterten Eigenschaften und Methoden aus der aktuellen Sitzung. Remove-TypeData löscht die Types.ps1xml Dateien nicht oder löscht keine erweiterten Typdefinitionen aus den Types.ps1xml Dateien. Weitere Informationen zu Types.ps1xml Dateien finden Sie unter about_Types.ps1xml.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Entfernen von Typdaten für einen angegebenen Typ

In diesem Beispiel werden alle Typdaten für den System.Array- Typ aus der Sitzung gelöscht, einschließlich Typdaten, die von einer Types.ps1xml Datei und dynamischen Typdaten hinzugefügt wurden, die der Sitzung mithilfe des Cmdlets Update-TypeData hinzugefügt wurden.

Remove-TypeData -TypeName System.Array

Beispiel 2: Entfernen eines erweiterten Datentyps aus einer Sitzung

In diesem Beispiel wird der Effekt gezeigt, dass erweiterte Typdaten aus einer Sitzung entfernt werden. Der erste Get-TypeData erhält erweiterte Typdaten für den System.DateTime- Typ. Die Ausgabe zeigt, dass allen System.DateTime--Objekten in PowerShell eine DateTime-Eigenschaft DateTime hinzugefügt wurde. Das cmdlet Get-Date gibt ein System.DateTime-Objekt zurück. Der Befehl verwendet die Punktnotation, um den Wert der DateTime -Eigenschaft des System.DateTime- -Objekts abzurufen, das Get-Date zurückgibt.

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

Das nächste Get-TypeData Cmdlet, um alle erweiterten Typdaten für den System.DateTime- Typ abzurufen, und rohren sie an das Cmdlet Remove-TypeData, um die erweiterten Typdaten zu löschen. Das letzte Get-Date Cmdlet zeigt die Auswirkung des Löschens der erweiterten Typdaten für den System.DateTime- Typ. Da die System.DateTime--Eigenschaft nicht mehr vorhanden ist, gibt ein Befehl zum Abrufen seines Werts nichts zurück.

Beispiel 3: Entfernen erweiterter Typen für Module

In diesem Beispiel werden alle erweiterten Typdaten für Modulobjekte entfernt. Wenn Sie ein Objekt an Remove-TypeDataweitergeleitet haben, ruft Remove-TypeData den Namen des Objekttyps ab und entfernt alle Typdaten für alle Objekte dieses Typs.

Get-Module | Remove-TypeData

Beispiel 4: Entfernen erweiterter Typen aus angegebenen Modulen

In diesem Beispiel wird der parameter Path des Cmdlets Remove-TypeData verwendet, um die erweiterten Typen zu entfernen, die in den Types.ps1xml Dateien definiert sind, die vom PSScheduledJob und PSWorkflow Module hinzugefügt werden. Dieser Befehl wirkt sich nicht auf dynamische Typdaten aus, die mithilfe des Cmdlets Update-TypeData hinzugefügt werden. Der Befehl ist nur erfolgreich, wenn die Module in die aktuelle Sitzung importiert wurden.

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

Weitere Informationen zu Modulen finden Sie unter about_Modules.

Beispiel 5: Entfernen erweiterter Typen aus einer Remotesitzung

In diesem Beispiel werden erweiterte Typen aus einer Remotesitzung entfernt. Der Befehl verwendet das Cmdlet Invoke-Command, um erweiterte Typdaten für alle CIM-Typen in den Sitzungen in der variablen $S zu entfernen.

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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt ein Array von Dateien an, die dieses Cmdlet aus den Erweiterten Typdaten der Sitzung löscht. Dieser Parameter ist erforderlich.

Geben Sie die Pfade und Dateinamen einer oder mehrerer Types.ps1xml Dateien ein. Wildcards werden nicht unterstützt. Wenn Sie den Pfad weglassen, ist der Standardspeicherort das aktuelle Verzeichnis.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TypeData

Gibt die Typdaten an, die dieses Cmdlet aus der Sitzung löscht. Dieser Parameter ist erforderlich. Geben Sie eine Variable ein, die TypeData- -Objekte enthält (System.Management.Automation.Runspaces.TypeData) oder einen Befehl, der TypeData--Objekte abruft, z. B. einen Get-TypeData Befehl. Sie können auch TypeData- Objekte an Remove-TypeDataweitergeleitet werden.

Typ:TypeData
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TypeName

Gibt die Typen an, für die dieses Cmdlet alle erweiterten Typdaten löscht. Geben Sie für Typen im Systemnamespace den Kurznamen ein. Andernfalls ist der vollständige Typname erforderlich. Wildcards werden nicht unterstützt.

Sie können Typnamen an Remove-TypeDataweitergeleitet werden. Wenn Sie ein Objekt an Remove-TypeDataweitergeleitet haben, ruft Remove-TypeData den Typnamen des Objekts ab und entfernt alle Typdaten für den Objekttyp.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

TypeData

Sie können ein TypeData--Objekt, z. B. die objekte, die das cmdlet Get-TypeData zurückgibt, an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge mit dem Typnamen an dieses Cmdlet weiterleiten. Wenn Sie ein Objekt an dieses Cmdlet weiterleiten, ruft es den Typnamen des Objekts ab und entfernt alle Typdaten für den Objekttyp.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Remove-TypeData können nur die erweiterten Typdaten in der aktuellen Sitzung entfernen. Es können keine erweiterten Typdaten entfernt werden, die sich auf dem Computer befinden, aber nicht zur aktuellen Sitzung hinzugefügt wurden, z. B. erweiterte Typen, die in Modulen definiert sind, die nicht in die aktuelle Sitzung importiert wurden.