Remove-TypeData

模組:

Microsoft.PowerShell.Utility

從目前的工作階段中刪除擴充類型。

語法

PowerShell

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

PowerShell

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

PowerShell

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

Description

Remove-TypeData Cmdlet 會從目前的工作階段中刪除擴充類型數據。 此 Cmdlet 只會影響目前會話和目前會話中建立的會話。

您可以在 Update-TypeData 命令和 Types.ps1xml 檔案中定義屬性和方法，將屬性和方法新增至 PowerShell 中的物件。 Remove-TypeData 會從目前的工作階段中刪除這些擴充屬性和方法。 Remove-TypeData 不會刪除 Types.ps1xml 檔案，也不會從 Types.ps1xml 檔案中刪除任何擴充類型定義。 如需 Types.ps1xml 檔案的詳細資訊，請參閱 about_Types.ps1xml。

此 Cmdlet 已在 Windows PowerShell 3.0 中引進。

範例

範例 1：移除指定類型的類型數據

此範例會從會話中刪除 System.Array 類型的所有類型數據，包括 Types.ps1xml 檔案所新增的類型數據，以及使用 Update-TypeData Cmdlet 新增至會話的動態類型數據。

PowerShell

Remove-TypeData -TypeName System.Array

範例 2：從會話中移除擴充數據類型

此範例顯示從會話移除擴充型別數據的效果。 第一個 Get-TypeData 會取得 System.DateTime 類型的擴充型別數據。 輸出顯示 PowerShell 中已將 DateTime 屬性新增至所有 System.DateTime 物件。 Get-Date Cmdlet 會傳回 System.DateTime 物件。 此命令會使用點表示法來 取得 Get-Date 傳回之 system.DateTime System.DateTime 屬性值。

PowerShell

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

下一個 Get-TypeData Cmdlet，以取得 System.DateTime 類型的所有擴充類型數據，以及傳送至 Remove-TypeData Cmdlet 以刪除擴充類型數據。 最後一個 Get-Date Cmdlet 會顯示刪除 System.DateTime 類型的擴充類型數據的效果。 因為 System.DateTime 屬性已不存在，因此取得其值的命令不會傳回任何內容。

範例 3：移除模組的擴充類型

此範例會移除模組物件的所有擴充類型數據。 當您使用管線將對象傳送至 Remove-TypeData時，Remove-TypeData 取得物件類型的名稱，並移除該類型之所有物件的所有型別數據。

PowerShell

Get-Module | Remove-TypeData

範例 4：從指定的模組中移除擴充類型

這個範例會使用 Remove-TypeData Cmdlet 的 Path 參數，移除 PSScheduledJob 和 PSWorkflow 模組所新增之 Types.ps1xml 檔案中定義的擴充類型。 此命令不會影響使用 Update-TypeData Cmdlet 新增的動態類型數據。 只有在模組已匯入目前的會話時，命令才會成功。

PowerShell

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

如需模組的詳細資訊，請參閱 about_Modules。

範例 5：從遠端會話移除擴充類型

此範例會從遠端會話中移除擴充類型。 此命令會使用 Invoke-Command Cmdlet 來移除 $S 變數中會話中所有 CIM 類型的擴充型別數據。

PowerShell

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

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

指定此 Cmdlet 從會話擴充類型數據中刪除的檔案陣列。 這是必要參數。

輸入一或多個 Types.ps1xml 檔案的路徑和檔名。 不支援通配符。 如果您省略路徑，預設位置是目前目錄。

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-TypeData

指定此 Cmdlet 從工作階段中刪除的類型資料。 這是必要參數。 輸入變數，其中包含 TypeData 物件（System.Management.Automation.Runspaces.TypeData）或取得 TypeData 物件的命令，例如Get-TypeData 命令。 您也可以使用管線 TypeData 物件來 Remove-TypeData。

類型:	TypeData
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-TypeName

指定此 Cmdlet 刪除所有擴充型別數據的類型。 針對 System 命名空間中的類型，輸入簡短名稱。 否則，需要完整類型名稱。 不支援通配符。

您可以使用管線將類型名稱傳送至 Remove-TypeData。 當您使用管線將對象傳送至 Remove-TypeData時，Remove-TypeData 取得對象的類型名稱，並移除物件類型的所有類型數據。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

TypeData

您可以使用管線將 typeData 物件，例如 Get-TypeData Cmdlet 傳回的物件傳送至此 Cmdlet。

String

您可以使用管線將包含類型名稱的字串傳送至此 Cmdlet。 當您使用管線將對象傳送至這個 Cmdlet 時，它會取得物件的類型名稱，並移除物件類型的所有類型數據。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

Remove-TypeData 只能移除目前會話中的擴充型別數據。 它無法移除電腦上的擴充類型數據，但尚未新增至目前的會話，例如未匯入目前會話之模組中所定義的擴充類型。

相關連結

• Get-TypeData
• Update-TypeData