Set-CMComputerAssociation
Configuration Manager のコンピューター関連付けの設定を変更します。
構文
Set-CMComputerAssociation
[-AddMigrationUserName <String[]>]
-DestinationComputer <String>
[-MigrationBehavior <MigrationBehavior>]
[-RemoveMigrationUserName <String[]>]
-SourceComputer <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMComputerAssociation
[-AddMigrationUserName <String[]>]
[-MigrationBehavior <MigrationBehavior>]
-MigrationId <String>
[-RemoveMigrationUserName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-CMComputerAssociation コマンドレットは、移行に使用されるコンピューターの関連付けの設定を変更します。 Configuration Manager では、オペレーティング システムの展開の一環として、ユーザーの状態と設定を既存のコンピューターから別のコンピューターに移行できます。 移行の過程で、Configuration Manager はソース コンピューターで作成されたアカウントを保存し、それらのユーザー アカウントを移行先コンピューターに作成します。
コンピューターの関連付けには、移行するユーザー名と、ソース コンピューターから他のユーザー名を処理する方法が含まれています。 このコマンドレットを使用して、関連付けを変更できます。 関連付けにユーザー名を追加したり、ユーザー名を削除したりできます。 また、Configuration Manager にソース コンピューターの他のユーザー名を含めるかどうかを変更することもできます。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: コンピューターの関連付けを変更する
PS XYZ:\> Set-CMComputerAssociation -DestinationComputer "TSQA155" -SourceComputer "TSQA073" -AddMigrationUserName "ContosoTSQA\EvanNarvaez" -MigrationBehavior CaptureAllUserAccountsAndRestoreSpecifiedAccounts -RemoveMigrationUserName "ContosoTSQA\ElisaDaugherty"
このコマンドは、TSQA073 と TSQA155 という名前のコンピューター間の関連付けを変更します。 コマンドは、ユーザー ContosoTSQA\EvanNarvaez を追加し、ユーザー ContosoTSQA\ElisaDaugherty を削除します。 このコマンドは、移行動作を CaptureAllUserAccountsAndRestoreSpecifiedAccounts として指定します。そのため、関連付けにより、移行元コンピューターで作成されたすべてのアカウントが保存されますが、移行先コンピューターでコンピューターの関連付けによって指定されたアカウントのみが作成されます。
パラメーター
-AddMigrationUserName
ソース コンピューターで作成されたアカウントのユーザー名の配列を指定します。 コマンドレットは、コンピューターの関連付けの現在の指定されたユーザー名にこれらのユーザー名を追加します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-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 がソース コンピューターで作成されたユーザー アカウントを処理する方法を指定します。 コンピューターの関連付けを作成するときは、New-CMComputerAssociation コマンドレットの MigrationUserName パラメーターを使用して、ソース コンピューターに作成されたユーザー アカウントを指定します。 コンピューターの関連付けでは、移行プロセスによって、移行先コンピューターにそれらのアカウントの一部またはすべてを作成することを指定できます。
このパラメーターの有効な値は次のとおりです。
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts。 ソース コンピューターで作成されたすべてのアカウントを保存しますが、対象のコンピューターに指定したアカウントのみを作成します。
- CaptureAndRestoreAllUserAccounts。 ソース コンピューターで作成されたすべてのアカウントを保存し、コピー先コンピューターに作成します。
- CaptureAndRestoreSpecifiedUserAccounts。 指定したアカウントのみをソース コンピューターから保存し、対象のコンピューターにそれらのアカウントを作成します。
型: | MigrationBehavior |
指定可能な値: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MigrationId
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RemoveMigrationUserName
ソース コンピューターで作成されたアカウントのユーザー名の配列を指定します。 コマンドレットは、コンピューターの関連付けの現在の指定されたユーザー名からこれらのユーザー名を削除します。
型: | 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
出力
System.Object