Remove-TypeData
Löscht erweiterte Typen aus der aktuellen Sitzung.
Syntax
RemoveTypeDataSet (Standardwert)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
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 zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
RemoveFileSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | TypeData |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
RemoveTypeDataSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
RemoveTypeSet
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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.
