Remove-TypeData
从当前会话中删除扩展的类型。
语法
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
cmdlet Remove-TypeData
从当前会话中删除扩展类型数据。 此 cmdlet 只影响当前会话和当前会话中创建的会话。
可以通过在命令和文件中定义属性和方法,在 PowerShell 中 Update-TypeData
向对象添加属性和 Types.ps1xml
方法。 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
扩展类型。 此命令不会影响使用 Update-TypeData
cmdlet 添加的动态类型数据。 仅当已将模块导入当前会话时,此命令才能够成功执行。
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 对象(例如 Get-TypeData
cmdlet 返回的对象)传递给此 cmdlet。
可以通过管道将包含类型名称的字符串传递给此 cmdlet。 通过管道将对象传递给此 cmdlet 时,它将获取对象的类型名称,并删除该对象类型的所有类型数据。
输出
None
此 cmdlet 不返回任何输出。
备注
Remove-TypeData
只能删除当前会话中的扩展类型数据。 它无法删除位于计算机上的但未添加到当前会话的扩展类型数据,例如模块中定义的但未导入到当前会话中的扩展类型数据。