Remove-TypeData

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Törli a bővített típusokat az aktuális munkamenetből.

Syntax

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      [-TypeName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 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-Date DateTime 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: A 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

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Path

Olyan fájltömböt ad meg, amelyet ez a parancsmag töröl a munkamenet bővített 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. Helyettesítő karakterek nem használhatók. Ha kihagyja az elérési utat, az alapértelmezett hely az aktuális könyvtár.

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

-TypeData

Megadja azokat a típusadatokat, amelyeket ez 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 parancsotGet-TypeData. TypeData-objektumokat is becsúszthat a parancsba.Remove-TypeData

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

-TypeName

Megadja azokat a típusokat, amelyekhez ez a parancsmag az összes kiterjesztett típusadatot törli. 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ő. Helyettesítő karakterek nem használhatók.

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.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

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.