New-CMComputerAssociation
Configuration Manager で 2 台のコンピューター間の関連付けを作成します。
構文
New-CMComputerAssociation
-DestinationComputer <String>
[-MigrationBehavior <MigrationBehavior>]
[-MigrationUserName <String[]>]
-SourceComputer <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
New-CMComputerAssociation コマンドレットは、移行に使用する 2 つのコンピューター間に関連付けを作成します。 Configuration Manager では、オペレーティング システムの展開の一環として、ユーザーの状態と設定を既存のコンピューターから別のコンピューターに移行できます。 移行の過程で、Configuration Manager はソース コンピューターで作成されたアカウントを保存し、それらのユーザー アカウントを移行先コンピューターに作成します。
関連付けを作成するには、移行元コンピューター、移行先コンピューター、移行するソース コンピューターに作成された少なくとも 1 つのユーザー名を指定します。 移行にソース コンピューターからの他のユーザー名を含めるかどうかを指定することもできます。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: コンピューターの関連付けを作成する
PS XYZ:\> New-CMComputerAssociation -SourceComputer "TSQA073" -MigrationUserName "Contoso-TSQA\ElisaDaugherty" -DestinationComputer "TSQA155"このコマンドを実行すると、TSQA073 という名前のソース コンピューターと、TSQA155という名前の対象コンピューターとの間にコンピューターの関連付けが作成されます。 コマンドは、移行先コンピューターへの移行のユーザー名を指定します。
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationComputer
対象のコンピューターの名前を指定します。
| 型: | String |
| Aliases: | RestoreName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MigrationBehavior
Configuration Manager がソース コンピューターで作成されたユーザー アカウントを処理する方法を指定します。 コンピューターの関連付けを作成するときは、 MigrationUserName パラメーターを使用して、ソース コンピューターに作成されたユーザー アカウントを指定します。 コンピューターの関連付けでは、移行プロセスによって、移行先コンピューターにそれらのアカウントの一部またはすべてを作成することを指定できます。
このパラメーターの有効な値は次のとおりです。
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts。 ソース コンピューターで作成されたすべてのアカウントを保存しますが、対象のコンピューターに指定したアカウントのみを作成します。
- CaptureAndRestoreAllUserAccounts。 ソース コンピューターで作成されたすべてのアカウントを保存し、コピー先コンピューターに作成します。
- CaptureAndRestoreSpecifiedUserAccounts。 指定したアカウントのみをソース コンピューターから保存し、対象のコンピューターにそれらのアカウントを作成します。
移行動作を指定しない場合、移行では CaptureAndRestoreAllUserAccounts が使用されます。
| 型: | MigrationBehavior |
| 指定可能な値: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MigrationUserName
ソース コンピューターで作成されたアカウントのユーザー名の配列を指定します。 指定したユーザー名と MigrationBehavior パラメーターの設定により、Configuration Manager が移行先コンピューターに作成するユーザー アカウントが決まります。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SourceComputer
ソース コンピューターの名前を指定します。
| 型: | String |
| Aliases: | SourceName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject