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