通过

Move-CMObject

  • 参考
模块:
ConfigurationManager

将 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