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 にソース コンピューターの他のユーザー名が含まれるかどうかを変更することもできます。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 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
ソース コンピューター上に作成されたアカウントのユーザー名の配列を指定します。 コマンドレットは、これらのユーザー名をコンピューター関連付けの現在の指定されたユーザー名に追加します。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationComputer
移動先のコンピューターの名前を指定します。
Type: | String |
Aliases: | RestoreName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MigrationBehavior
Configuration Manager がソース コンピューター上に作成されたユーザー アカウントを処理する方法を指定します。 コンピューターの関連付けを作成する場合は、New-CMComputerAssociationコマンドレットのMigrationUserNameパラメーターを使用して、ソース コンピューター上に作成されたユーザー アカウントを指定します。 コンピューターの関連付けでは、移行プロセスによって、移行先のコンピューターにそれらのアカウントの一部またはすべてが作成されます。
このパラメーターの有効な値は次のとおりです。
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts。 ソース コンピューター上に作成されたアカウントはすべて保存しますが、コピー先のコンピューターには指定したアカウントのみを作成します。
- CaptureAndRestoreAllUserAccounts。 ソース コンピューター上に作成されたアカウントを保存し、コピー先のコンピューターに作成します。
- CaptureAndRestoreSpecifiedUserAccounts。 指定したアカウントのみをソース コンピューターから保存し、それらのアカウントをコピー先のコンピューターに作成します。
Type: | MigrationBehavior |
Accepted values: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MigrationId
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveMigrationUserName
ソース コンピューター上に作成されたアカウントのユーザー名の配列を指定します。 コマンドレットは、コンピューター関連付けの現在の指定されたユーザー名からこれらのユーザー名を削除します。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceComputer
ソース コンピューターの名前を指定します。
Type: | String |
Aliases: | SourceName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
なし
出力
System.Object