Remove-TypeData
Törli a bővített típusokat az aktuális munkamenetből.
Syntax
RemoveTypeDataSet (Alapértelmezett)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Remove-TypeData parancsmag törli a bővített típusadatokat az aktuális munkamenetből. Ez a parancsmag csak az aktuális munkamenetre és az aktuális munkamenetben létrehozott munkamenetekre vonatkozik.
Tulajdonságokat és metódusokat adhat hozzá az objektumokhoz a PowerShellben, ha parancsokban és Types.ps1xml fájlokban Update-TypeData definiálja őket.
Remove-TypeData törli ezeket a kiterjesztett tulajdonságokat és metódusokat az aktuális munkamenetből.
Remove-TypeData nem törli a Types.ps1xml fájlokat, és nem töröl kiterjesztett típusdefiníciókat a Types.ps1xml fájlokból. További információ a fájlokról Types.ps1xml : about_Types.ps1xml.
Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.
Példák
1. példa: Adott típus típusadatainak eltávolítása
Ez a példa törli a System.Array típus összes típusadatait a munkamenetből, beleértve a fájl által Types.ps1xml hozzáadott típusadatokat, valamint a Update-TypeData parancsmag használatával a munkamenethez hozzáadott dinamikus típusadatokat.
Remove-TypeData -TypeName System.Array
2. példa: Kiterjesztett adattípus eltávolítása egy munkamenetből
Ez a példa a kiterjesztett típusú adatok munkamenetből való eltávolításának hatását mutatja be. Az első Get-TypeData a System.DateTime típus kiterjesztett típusadatait kapja meg. A kimenet azt mutatja, hogy egy DateTime tulajdonság lett hozzáadva a PowerShell összes System.DateTime objektumához. A Get-Date parancsmag egy System.DateTime objektumot ad vissza. A parancs pont jelölést használ a visszaadott System.DateTime objektum Get-DateDateTime tulajdonságának értékének lekéréséhez.
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
A következő Get-TypeData parancsmag, amely lekéri a System.DateTime típus összes kiterjesztett típusadatait, valamint a parancsmaghoz tartozó csöveket a Remove-TypeData kiterjesztett típusú adatok törléséhez. Az utolsó Get-Date parancsmag a System.DateTime típus kiterjesztett típusadatainak törlésének hatását mutatja. Mivel a System.DateTime tulajdonság már nem létezik, az érték lekérésére vonatkozó parancs nem ad vissza semmit.
3. példa: Modulok kiterjesztett típusainak eltávolítása
Ez a példa eltávolítja a modulobjektumok összes kiterjesztett típusadatait. Amikor egy objektumot az objektumba Remove-TypeDatacsövez, Remove-TypeData lekéri az objektumtípus nevét, és eltávolítja az adott típusú összes objektum összes típusadatait.
Get-Module | Remove-TypeData
4. példa: Kiterjesztett típusok eltávolítása a megadott modulokból
Ez a példa a Remove-TypeData parancsmag Path paraméterével távolítja el a PSScheduledJob és a PSWorkflow modulok által hozzáadott fájlokban Types.ps1xml definiált kiterjesztett típusokat. Ez a parancs nem befolyásolja a parancsmaggal Update-TypeData hozzáadott dinamikus típusú adatokat. A parancs csak akkor sikeres, ha a modulokat importálták az aktuális munkamenetbe.
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
A modulokkal kapcsolatos további információkért lásd: about_Modules.
5. példa: Kiterjesztett típusok eltávolítása távoli munkamenetből
Ez a példa eltávolítja a kiterjesztett típusokat egy távoli munkamenetből. A parancs a parancsmaggal távolítja el a Invoke-Command változó munkameneteiben lévő összes CIM-típus kiterjesztett típusadatait $S .
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Megadja azokat a fájlokat, amelyeket ez a parancsmag töröl a munkamenet kiterjesztett típusadataiból. Ez a paraméter kötelező.
Adja meg egy vagy több Types.ps1xml fájl elérési útját és fájlnevét. A helyettesítő karakterek nem támogatottak. Ha kihagyja az elérési utat, az alapértelmezett hely az aktuális könyvtár.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
RemoveFileSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-TypeData
Megadja azokat a típusadatokat, amelyeket a parancsmag töröl a munkamenetből. Ez a paraméter kötelező. Adjon meg egy TypeData-objektumokat (System.Management.Automation.Runspaces.TypeData) tartalmazó változót, vagy egy TypeData-objektumokat lekérő parancsot, például egy parancsot Get-TypeData .
TypeData-objektumokat is becsúszthat a parancsbaRemove-TypeData.
Paramétertulajdonságok
| Típus: | TypeData |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
RemoveTypeDataSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-TypeName
Megadja azokat a típusokat, amelyekhez ez a parancsmag törli az összes kiterjesztett típusadatot. A rendszernévtérben lévő típusok esetén adja meg a rövid nevet. Ellenkező esetben a teljes típusnév megadása kötelező. A helyettesítő karakterek nem támogatottak.
A pipe type names to Remove-TypeData. Amikor egy objektumot az objektumba Remove-TypeDatacsövez, Remove-TypeData lekéri az objektum típusnevét, és eltávolítja az objektumtípus összes típusadatait.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
RemoveTypeSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
TypeData
Ebbe a parancsmagba egy TypeData-objektumot , például a Get-TypeData parancsmag által visszaadott objektumokat is be lehet csövezni.
String
A típusnevet tartalmazó sztringet erre a parancsmagra csövezheti. Amikor egy objektumot erre a parancsmagra csövez, az megkapja az objektum típusnevét, és eltávolítja az objektumtípus összes típusadatait.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
Remove-TypeData az aktuális munkamenetben csak a kiterjesztett típusú adatok távolíthatók el. Nem távolíthatja el a számítógépen található kiterjesztett típusadatokat, de nem lett hozzáadva az aktuális munkamenethez, például az aktuális munkamenetbe nem importált modulokban definiált kiterjesztett típusokat.
