New-CMComputerAssociation
Crée une association entre deux ordinateurs dans Configuration Manager.
Syntaxe
New-CMComputerAssociation
-DestinationComputer <String>
[-MigrationBehavior <MigrationBehavior>]
[-MigrationUserName <String[]>]
-SourceComputer <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-CMComputerAssociation crée une association entre deux ordinateurs à utiliser pour la migration. Configuration Manager peut migrer l’état et les paramètres utilisateur d’un ordinateur existant vers un autre ordinateur dans le cadre du déploiement du système d’exploitation. Au cours de la migration, Configuration Manager enregistre les comptes créés sur l’ordinateur source et crée ces comptes d’utilisateur sur l’ordinateur de destination.
Pour créer une association, spécifiez l’ordinateur source, l’ordinateur de destination et au moins un nom d’utilisateur créé sur l’ordinateur source à migrer. Vous pouvez également spécifier si la migration inclut d’autres noms d’utilisateur de l’ordinateur source.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Créer une association d’ordinateurs
PS XYZ:\> New-CMComputerAssociation -SourceComputer "TSQA073" -MigrationUserName "Contoso-TSQA\ElisaDaugherty" -DestinationComputer "TSQA155"Cette commande crée une association d’ordinateurs entre l’ordinateur source nommé TSQA073 et l’ordinateur de destination nommé TSQA155. La commande spécifie un nom d’utilisateur pour la migration vers l’ordinateur de destination.
Paramètres
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DestinationComputer
Spécifie le nom d’un ordinateur de destination.
| Type: | String |
| Alias: | RestoreName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MigrationBehavior
Spécifie la façon dont Configuration Manager traite les comptes d’utilisateur créés sur l’ordinateur source. Lorsque vous créez une association d’ordinateurs, spécifiez les comptes d’utilisateur créés sur l’ordinateur source à l’aide du paramètre MigrationUserName . L’association d’ordinateurs peut spécifier que le processus de migration crée tout ou partie de ces comptes sur l’ordinateur de destination.
Les valeurs acceptables pour ce paramètre sont les suivantes :
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts. Enregistre tous les comptes créés sur l’ordinateur source, mais crée uniquement les comptes spécifiés sur l’ordinateur de destination.
- CaptureAndRestoreAllUserAccounts. Enregistre tous les comptes créés sur l’ordinateur source et les crée sur l’ordinateur de destination.
- CaptureAndRestoreSpecifiedUserAccounts. Enregistre uniquement les comptes spécifiés à partir de l’ordinateur source et crée ces comptes sur l’ordinateur de destination.
Si vous ne spécifiez pas de comportement de migration, la migration utilise CaptureAndRestoreAllUserAccounts.
| Type: | MigrationBehavior |
| Valeurs acceptées: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MigrationUserName
Spécifie un tableau de noms d’utilisateur pour les comptes créés sur l’ordinateur source. Les noms d’utilisateur spécifiés, ainsi que le paramètre MigrationBehavior , déterminent les comptes d’utilisateur que Configuration Manager crée sur l’ordinateur de destination.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SourceComputer
Spécifie le nom de l’ordinateur source.
| Type: | String |
| Alias: | SourceName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
None
Sorties
IResultObject