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 コマンドレットは、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 パラメーターで使用されるキーワードと一致させます。
これらのオブジェクトを取得するには、次のいずれかのコマンドレットを使用します。
- Get-CMApplication
- Get-CMPackage
- Get-CMDriverPackage
- Get-CMOperatingSystemImage
- Get-CMOperatingSystemInstaller
- Get-CMBootImage
- Get-CMTaskSequence
型: | 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