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 im Rahmen der Betriebssystembereitstellung den Benutzerstatus und die Einstellungen von einem vorhandenen Computer auf einen anderen Computer migrieren. Während 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. Mit diesem Cmdlet können Sie eine Zuordnung ä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 beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. 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"

Mit diesem Befehl wird die Zuordnung zwischen dem Computer namens TSQA073 und TSQA155 geändert. Der Befehl fügt den Benutzer ContosoTSQA\EvanNarvaez hinzu und entfernt den Benutzer ContosoTSQA\CsvDaugherty. Der Befehl gibt das Migrationsverhalten als CaptureAllUserAccountsAndRestoreSpecifiedAccounts an, sodass die Zuordnung bewirkt, dass die Migration alle konten speichert, die auf dem Quellcomputer erstellt wurden, aber nur, um die von der Computerzuordnung auf dem Zielcomputer angegebenen Konten 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.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationComputer

Gibt den Namen eines Zielcomputers an.

Type:String
Aliases:RestoreName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 mithilfe des Migrationsbenutzernamen-Parameters des Cmdlets "New-CMComputerAssociation" erstellt wurden. Die Computerzuordnung kann angeben, dass beim Migrationsvorgang einige oder alle dieser Konten auf dem Zielcomputer erstellt werden.

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.
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

Gibt ein Array von Benutzernamen für Konten an, die auf dem Quellcomputer erstellt wurden. Das Cmdlet entfernt diese Benutzernamen aus den aktuellen angegebenen Benutzernamen der Computerzuordnung.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SourceComputer

Gibt den Namen des Quellcomputers an.

Type:String
Aliases:SourceName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Keine

Ausgaben

System.Object