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 コマンドレットは、Configuration Manager オブジェクトを別のフォルダーに移動します。 移動するオブジェクトと移動先フォルダーを指定します。 オブジェクトは 1 つのフォルダーにのみ存在するため、コマンドレットは現在のフォルダーを指定しません。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 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

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FolderPath

宛先フォルダー パスを次の形式で指定します: <site code>:\<object type>\folder\subfolder\subfolder。

  • <site code>: Configuration Manager サイト コード。
  • <object type>: 移動するオブジェクトの種類に関する次のいずれかのキーワード。
    • Application
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Package
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

たとえば、サイト CM1 のアプリケーションの LOB Apps という名前のフォルダーには、次のファイル パスがあります: CM1:\Application\LOB Apps。

ルート フォルダーにオブジェクトを移動するには、フォルダーを指定しないでください。 たとえば、「 CM1:\Application 」のように入力します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

移動する Configuration Manager オブジェクトの配列を指定します。 配列を指定する場合は、同じオブジェクト型を使用します。 オブジェクトの種類を 、-FolderPath パラメーターで使用されるキーワードと一致させます。

これらのオブジェクトを取得するには、次のいずれかのコマンドレットを使用します。

型:IResultObject[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ObjectId

移動するオブジェクト ID の配列を指定します。 配列を指定する場合は、同じオブジェクト型を使用します。 オブジェクトの種類を 、-FolderPath パラメーターで使用されるキーワードと一致させます。

たとえば、「 XYZ00550 」のように入力します。

型:String[]
Aliases:InstanceKey
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

出力

System.Object