Share via

Remove-TypeData

  • 參考
模組:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

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

您可以在命令和檔案中定義屬性和方法，將屬性和Types.ps1xml方法新增至PowerShell中的Update-TypeData物件。 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 新增至工作階段的動態類型數據。

Remove-TypeData -TypeName System.Array

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

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

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 取得物件類型的名稱，並移除該類型之所有物件的所有型別數據。

Get-Module | Remove-TypeData

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

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

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

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

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

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

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

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-Path

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

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

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

-TypeData

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

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

-TypeName

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

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

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

TypeData

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

String

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

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

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