Set-CMComputerAssociation
Ändert die Einstellungen für eine Computerzuordnung in Configuration Manager.
Syntax
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>] Beschreibung
Das Cmdlet Set-CMComputerAssociation ändert die Einstellungen für eine Computerzuordnung, die für die Migration verwendet wird. Configuration Manager kann den Benutzerzustand und die Einstellungen im Rahmen der Betriebssystembereitstellung von einem vorhandenen Computer zu einem anderen Computer migrieren. Im Zuge der Migration speichert Configuration Manager Konten, die auf dem Quellcomputer erstellt wurden, und erstellt diese Benutzerkonten auf dem Zielcomputer.
Eine Computerzuordnung enthält die zu migrierenden Benutzernamen und den Umgang mit anderen Benutzernamen vom Quellcomputer. Sie können dieses Cmdlet verwenden, um eine Zuordnung zu ändern. Sie können der Zuordnung Benutzernamen hinzufügen oder Benutzernamen entfernen. Sie können auch ändern, ob Configuration Manager andere Benutzernamen vom Quellcomputer enthält.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Ändern einer Computerzuordnung
PS XYZ:\> Set-CMComputerAssociation -DestinationComputer "TSQA155" -SourceComputer "TSQA073" -AddMigrationUserName "ContosoTSQA\EvanNarvaez" -MigrationBehavior CaptureAllUserAccountsAndRestoreSpecifiedAccounts -RemoveMigrationUserName "ContosoTSQA\ElisaDaugherty"Dieser Befehl ändert die Zuordnung zwischen dem Computer namens TSQA073 und TSQA155. Der Befehl fügt den Benutzer ContosoTSQA\EvanNarvaez hinzu und entfernt den Benutzer ContosoTSQA\ElisaDaugherty. Der Befehl gibt das Migrationsverhalten als CaptureAllUserAccountsAndRestoreSpecifiedAccounts an, sodass die Zuordnung bewirkt, dass die Migration alle auf dem Quellcomputer erstellten Konten speichert, aber nur, um die von der Computerzuordnung angegebenen Konten auf dem Zielcomputer zu erstellen.
Parameter
-AddMigrationUserName
Gibt ein Array von Benutzernamen für Konten an, die auf dem Quellcomputer erstellt wurden. Das Cmdlet fügt diese Benutzernamen den aktuell angegebenen Benutzernamen der Computerzuordnung hinzu.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DestinationComputer
Gibt den Namen eines Zielcomputers an.
| Typ: | String |
| Aliase: | RestoreName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MigrationBehavior
Gibt an, wie Configuration Manager benutzerkonten behandelt, die auf dem Quellcomputer erstellt wurden. Wenn Sie eine Computerzuordnung erstellen, geben Sie benutzerkonten an, die auf dem Quellcomputer erstellt wurden, indem Sie den Parameter MigrationUserName des Cmdlets New-CMComputerAssociation verwenden. Die Computerzuordnung kann angeben, dass der Migrationsprozess einige oder alle dieser Konten auf dem Zielcomputer erstellt.
Folgende Werte sind für diesen Parameter zulässig:
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts. Speichert alle auf dem Quellcomputer erstellten Konten, erstellt jedoch nur die angegebenen Konten auf dem Zielcomputer.
- CaptureAndRestoreAllUserAccounts. Speichert alle auf dem Quellcomputer erstellten Konten und erstellt sie auf dem Zielcomputer.
- CaptureAndRestoreSpecifiedUserAccounts. Speichert nur die angegebenen Konten vom Quellcomputer und erstellt diese Konten auf dem Zielcomputer.
| Typ: | MigrationBehavior |
| Zulässige Werte: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MigrationId
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RemoveMigrationUserName
Gibt ein Array von Benutzernamen für Konten an, die auf dem Quellcomputer erstellt wurden. Das Cmdlet entfernt diese Benutzernamen aus den aktuell angegebenen Benutzernamen der Computerzuordnung.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SourceComputer
Gibt den Namen des Quellcomputers an.
| Typ: | String |
| Aliase: | SourceName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
System.Object