Move-CMObject

将 Configuration Manager 对象移到其他文件夹中。

语法

Move-CMObject
    -FolderPath <String>
    -InputObject <IResultObject[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-CMObject
    -FolderPath <String>
    -ObjectId <String[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Move-CMObject cmdlet 将 Configuration Manager 对象移到其他文件夹中。 指定要移动的对象和目标文件夹。 由于对象仅存在于一个文件夹中,因此 cmdlet 不指定当前文件夹。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:按对象移动应用

此示例首先按名称获取应用程序对象。 然后,它将对象移动到 TestFolder 文件夹。

$app = Get-CMApplication -Name "Teams"
Move-CMObject -FolderPath "XYZ:\Application\TestFolder" -InputObject $app

示例 2:按 ID 移动任务序列

本示例将包含包 ID 的任务序列XYZ00550 移动到 “开发 ”文件夹。

Move-CMObject -FolderPath "XYZ:\TaskSequence\Development" -ObjectId "XYZ00550"

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FolderPath

指定目标文件夹路径,格式如下: <site code>:\<object type>\folder\subfolder\subfolder

  • <site code>:Configuration Manager 站点代码。
  • <object type>:要移动的对象类型的以下关键字之一:
    • 应用程序
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • 程序包
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

例如,站点 CM1 中应用程序名为 LOB Apps 的文件夹具有以下文件路径: CM1:\Application\LOB Apps

若要将对象移动到根文件夹,请不要指定文件夹。 例如,CM1:\Application

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要移动的 Configuration Manager 对象的数组。 如果指定数组,请使用同一对象类型。 将对象类型与 用于 -FolderPath 参数的 关键字匹配。

使用以下 cmdlet 之一来获取这些对象:

类型:IResultObject[]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ObjectId

指定要移动的对象 ID 的数组。 如果指定数组,请使用同一对象类型。 将对象类型与 用于 -FolderPath 参数的 关键字匹配。

例如,XYZ00550

类型:String[]
别名:InstanceKey
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

输出

System.Object