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 つのユーザー名を指定します。 移行にソース コンピューターからの他のユーザー名が含まれるかどうかを指定することもできます。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: コンピューターの関連付けを作成する
PS XYZ:\> New-CMComputerAssociation -SourceComputer "TSQA073" -MigrationUserName "Contoso-TSQA\ElisaDaugherty" -DestinationComputer "TSQA155"
このコマンドは、TSQA073 という名前のソース コンピューターと TSQA155 という名前の宛先コンピューターとの間にコンピューターの関連付けを作成します。 このコマンドは、移行先のコンピューターに移行するユーザー名を指定します。
パラメーター
-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 がソース コンピューター上に作成されたユーザー アカウントを処理する方法を指定します。 コンピューターの関連付けを作成する場合は 、MigrationUserName パラメーターを使用して、ソース コンピューター上に作成されたユーザー アカウントを指定します。 コンピューターの関連付けでは、移行プロセスによって、移行先のコンピューターにそれらのアカウントの一部またはすべてが作成されます。
このパラメーターの有効な値は次のとおりです。
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts。 ソース コンピューター上に作成されたアカウントはすべて保存しますが、コピー先のコンピューターには指定したアカウントのみを作成します。
- CaptureAndRestoreAllUserAccounts。 ソース コンピューター上に作成されたアカウントを保存し、コピー先のコンピューターに作成します。
- CaptureAndRestoreSpecifiedUserAccounts。 指定したアカウントのみをソース コンピューターから保存し、それらのアカウントをコピー先のコンピューターに作成します。
移行動作を指定しない場合、移行では CaptureAndRestoreAllUserAccounts が使用されます。
Type: | MigrationBehavior |
Accepted values: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MigrationUserName
ソース コンピューター上に作成されたアカウントのユーザー名の配列を指定します。 指定したユーザー名と MigrationBehavior パラメーター設定によって、Configuration Manager が移行先のコンピューターで作成するユーザー アカウントを決定します。
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 |
入力
なし
出力
IResultObject