Set-CMComputerAssociation
Modifie les paramètres d’une association d’ordinateurs dans 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>]L’applet de commande Set-CMComputerAssociation modifie les paramètres d’une association d’ordinateurs utilisée 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.
Une association d’ordinateurs contient les noms d’utilisateur à migrer et comment traiter d’autres noms d’utilisateur à partir de l’ordinateur source. Vous pouvez utiliser cette applet de commande pour modifier une association. Vous pouvez ajouter des noms d’utilisateur à l’association ou supprimer des noms d’utilisateur. Vous pouvez également modifier si Configuration Manager inclut d’autres noms d’utilisateur de l’ordinateur source.
Notes
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.
PS XYZ:\> Set-CMComputerAssociation -DestinationComputer "TSQA155" -SourceComputer "TSQA073" -AddMigrationUserName "ContosoTSQA\EvanNarvaez" -MigrationBehavior CaptureAllUserAccountsAndRestoreSpecifiedAccounts -RemoveMigrationUserName "ContosoTSQA\ElisaDaugherty"Cette commande modifie l’association entre l’ordinateur nommé TSQA073 et TSQA155. La commande ajoute l’utilisateur ContosoTSQA\EvanNarvaez et supprime l’utilisateur ContosoTSQA\ElisaDaugherty. La commande spécifie le comportement de migration Comme CaptureAllUserAccountsAndRestoreSpecifiedAccounts, l’association entraîne l’enregistrement de tous les comptes créés sur l’ordinateur source, mais uniquement les comptes spécifiés par l’association d’ordinateurs sur l’ordinateur de destination.
Spécifie un tableau de noms d’utilisateur pour les comptes créés sur l’ordinateur source. L’applet de commande ajoute ces noms d’utilisateur aux noms d’utilisateur spécifiés actuels de l’association d’ordinateurs.
| 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 |
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 |
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 |
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 |
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 |
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 de l’applet de commande New-CMComputerAssociation . 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.
| 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 |
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Spécifie un tableau de noms d’utilisateur pour les comptes créés sur l’ordinateur source. L’applet de commande supprime ces noms d’utilisateur des noms d’utilisateur spécifiés actuels de l’association d’ordinateurs.
| 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 |
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 |
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 |
None
System.Object