通过将 *.types.ps1xml 文件重新加载到内存中来更新当前的扩展类型配置。
语法
Update-TypeData [[-AppendPath] <string[]>] [-PrependPath <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
说明
Update-TypeData cmdlet 通过将 *.types.ps1xml 文件重新加载到内存,更新当前扩展的类型配置。如果 Windows PowerShell 需要扩展类型信息所包含的类型信息,则通常会加载扩展类型信息。Update-TypeData cmdlet 可用于预加载所有类型信息。在开发类型并希望加载这些新类型以进行测试时,此命令尤其有用。
有关 Windows PowerShell 中 *types.ps1xml 文件的详细信息,请参阅 about_Types.ps1xml。
参数
-AppendPath <string[]>
指定要包括在已加载文件列表中的可选 .ps1xml 文件的路径。在加载内置文件后,将对这些文件进行处理。
是否为必需? |
false |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
true (ByValue, ByPropertyName) |
是否接受通配符? |
false |
-PrependPath <string[]>
指定要包括在已加载文件列表中的可选 .ps1xml 文件的路径。不过,在加载内置文件之前,将按指定这些文件的顺序对其进行处理。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-Confirm
在执行命令之前提示您进行确认。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-WhatIf
描述如果执行该命令会发生什么情况(无需实际执行该命令)。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
System.String 可以通过管道将包含追加路径的字符串传递给 Update-TypeData。 |
输出 |
None 此 cmdlet 不返回任何输出。 |
示例 1
C:\PS>update-typedata 说明 ----------- 此示例更新 *.types.ps1xml 文件中的扩展类型配置。
示例 2
C:\PS>update-typedata -prependpath typesA.types.Ps1xml, typesB.types.Ps1xml 说明 ----------- 此示例更新 *.types.ps1xml 文件中的扩展类型配置,以便先处理 typesA 和 typesB 文件。