Add-Computer
Fügt den lokalen Computer einer Domäne oder Arbeitsgruppe hinzu.
Syntax
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
-Credential <PSCredential>
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Beschreibung
Das Add-Computer Cmdlet fügt den lokalen Computer oder Remotecomputer einer Domäne oder Arbeitsgruppe hinzu oder verschiebt sie von einer Domäne in eine andere.
Außerdem erstellt das Cmdlet ein Domänenkonto, falls der Computer der Domäne ohne Konto hinzugefügt wird.
Mit den Parametern dieses Cmdlets können Sie eine Organisationseinheit und einen Domänencontroller angeben oder einen unsicheren Beitritt ausführen.
Rufen Sie die Ergebnisse des Befehls mit dem Verbose- und dem PassThru-Parameter ab.
Beispiele
Beispiel 1: Hinzufügen eines lokalen Computers zu einer Domäne und anschließendes Neustarten des Computers
Add-Computer -DomainName Domain01 -RestartMit diesem Befehl wird der lokale Computer der Domäne %%amp;quot;Domain01%%amp;quot; hinzugefügt und anschließend neu gestartet, damit die Änderung wirksam wird.
Beispiel 2: Hinzufügen eines lokalen Computers zu einer Arbeitsgruppe
Add-Computer -WorkgroupName WORKGROUP-AMit diesem Befehl wird der lokale Computer der Arbeitsgruppe %%amp;quot;Workgroup-A%%amp;quot; hinzugefügt.
Beispiel 3: Hinzufügen eines lokalen Computers zu einer Domäne
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseDieser Befehl fügt den lokalen Computer unter Verwendung des Domänencontrollers %%amp;quot;Domain01\DC01%%amp;quot; der Domäne %%amp;quot;Domain01%%amp;quot; hinzu.
Der Befehl ruft mit dem PassThru-Parameter und dem Verbose-Parameter ausführliche Informationen zu den Ergebnissen des Befehls ab.
Beispiel 4: Hinzufügen eines lokalen Computers zu einer Domäne mithilfe des OUPath-Parameters
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"Mit diesem Befehl wird der lokale Computer der Domäne %%amp;quot;Domain02%%amp;quot; hinzugefügt. Dabei wird mit dem Parameter %%amp;quot;OUPath%%amp;quot; die Organisationseinheit für die neuen Konten angegeben.
Beispiel 5: Hinzufügen eines lokalen Computers zu einer Domäne mithilfe von Anmeldeinformationen
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceMit diesem Befehl wird der Computer %%amp;quot;Server01%%amp;quot; der Domäne %%amp;quot;Domain02%%amp;quot; hinzugefügt. Mit dem LocalCredential-Parameter wird ein Benutzerkonto angegeben, das über die Berechtigung zum Herstellen einer Verbindung mit dem Computer %%amp;quot;Server01%%amp;quot; verfügt. Mit dem Credential-Parameter wird ein Benutzerkonto angegeben, das über die Berechtigung zum Hinzufügen von Computern zur Domäne verfügt. Mit dem Restart-Parameter wird der Computer nach Abschluss des Beitrittsvorgangs neu gestartet. Mit dem Force-Parameter werden Meldungen zur Benutzerbestätigung unterdrückt.
Beispiel 6: Verschieben einer Gruppe von Computern in eine neue Domäne
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartMit diesem Befehl werden der Computer %%amp;quot;Server01%%amp;quot;, der Computer %%amp;quot;Server02%%amp;quot; und der lokale Computer von %%amp;quot;Domain01%%amp;quot; in %%amp;quot;Domain02%%amp;quot; verschoben.
Mit dem LocalCredential-Parameter wird ein Benutzerkonto angegeben, das über die Berechtigung zum Herstellen einer Verbindung mit den drei betroffenen Computern verfügt. Mit dem UnjoinDomainCredential-Parameter wird ein Benutzerkonto angegeben, das über die Berechtigung zum Trennen der Computer von der Domäne %%amp;quot;Domain01%%amp;quot; verfügt, und mit dem Credential-Parameter wird ein Benutzerkonto angegeben, das über die Berechtigung zum Entfernen der Computer aus der Domäne %%amp;quot;Domain02%%amp;quot; verfügt. Mit dem Restart-Parameter werden alle drei Computer nach dem Verschieben neu gestartet.
Beispiel 7: Verschieben eines Computers in eine neue Domäne und Ändern des Computernamens
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartMit diesem Befehl wird der Computer %%amp;quot;Server01%%amp;quot; in die Domäne %%amp;quot;Domain02%%amp;quot; verschoben, und der Computername wird in %%amp;quot;Server044%%amp;quot; geändert.
Der Befehl verwendet die Anmeldeinformationen des aktuellen Benutzers, um eine Verbindung mit dem Computer %%amp;quot;Server01%%amp;quot; herzustellen und ihn aus der aktuellen Domäne zu entfernen. Er verwendet den Credential-Parameter , um ein Benutzerkonto anzugeben, das über die Berechtigung zum Hinzufügen des Computers zur Domäne "Domain02" verfügt.
Beispiel 8: Hinzufügen von Computern, die in einer Datei aufgeführt sind, zu einer neuen Domäne
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartMit diesem Befehl werden die in der Datei %%amp;quot;Servers.txt%%amp;quot; aufgeführten Computer der Domäne %%amp;quot;Domain02%%amp;quot; hinzugefügt. Mit dem Options-Parameter wird die Win9xUpgrade-Option angegeben. Mit dem Restart-Parameter werden alle neu hinzugefügten Computer nach dem Beitrittsvorgang neu gestartet.
Parameter
-ComputerName
Gibt die einer Domäne oder Arbeitsgruppe hinzuzufügenden Computer an. Die Standardeinstellung ist der lokale Computer.
Geben Sie den NetBIOS-Namen, eine IP-Adresse (Internet Protocol) oder einen vollqualifizierten Domänennamen für jeden der Remotecomputer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder %%amp;quot;localhost%%amp;quot; ein.
Dieser Parameter beruht nicht auf Windows PowerShell-Remoting.
Sie können den ComputerName-Parameter von verwenden, auch wenn Ihr Computer nicht für die Ausführung von Add-Computer Remotebefehlen konfiguriert ist.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
| Type: | String[] |
| Position: | Named |
| Default value: | Local computer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Hinzufügen der Computer zu einer neuen Domäne verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. %%amp;quot;User01%%amp;quot; oder %%amp;quot;Domain01\User01%%amp;quot;, oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential-Cmdlet generiertes Objekt.
Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Geben Sie ein Benutzerkonto, das über die Berechtigung zum Entfernen des Computers aus der aktuellen Domäne verfügt, mit dem UnjoinDomainCredential-Parameter an. Geben Sie ein Benutzerkonto, das über die Berechtigung zum Herstellen einer Verbindung mit einem Remotecomputer verfügt, mit dem LocalCredential-Parameter an.
| Type: | PSCredential |
| Aliases: | DomainCredential |
| Position: | Named |
| Default value: | Current User Account Credentials |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
Gibt die Domäne an, der die Computer hinzugefügt werden. Dieser Parameter ist beim Hinzufügen der Computer zu einer Domäne erforderlich.
| Type: | String |
| Aliases: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Unterdrückt die Bestätigungsaufforderung.
Ohne diesen Parameter Add-Computer müssen Sie das Hinzufügen jedes Computers bestätigen.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit den durch den ComputerName-Parameter angegebenen Computern verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. %%amp;quot;User01%%amp;quot; oder %%amp;quot;Domain01\User01%%amp;quot;, oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential-Cmdlet generiertes Objekt.
Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Geben Sie ein Benutzerkonto, das über die Berechtigung zum Hinzufügen der Computer zu einer neuen Domäne verfügt, mit dem Credential-Parameter an. Geben Sie ein Benutzerkonto, das über die Berechtigung zum Entfernen der Computer aus der aktuellen Domäne verfügt, mit dem UnjoinDomainCredential-Parameter an.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Gibt einen neuen Namen für den Computer in der neuen Domäne an. Dieser Parameter ist nur gültig, wenn ein Computer hinzugefügt oder verschoben wird.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
Gibt erweiterte Optionen für den Add-Computer-Join-Vorgang an. Geben Sie Werte in einer durch Trennzeichen getrennten Zeichenfolge ein.
Zulässige Werte für diesen Parameter:
AccountCreate: Erstellt ein Domänenkonto. Das Cmdlet Add-Computer erstellt automatisch ein Domänenkonto, wenn es einer Domäne einen Computer hinzufügt. Diese Option ist aus Gründen der Vollständigkeit enthalten.
Win9XUpgrade: Gibt an, dass der Joinvorgang Teil eines Windows-Betriebssystemupgrades ist.
UnsecuredJoin: Führt einen ungesicherten Join aus. Um einen ungesicherten Join anzufordern, verwenden Sie den Parameter Unsecure oder diese Option.
PasswordPass: Legt das Computerkennwort auf den Wert des Parameters Credential(DomainCredential) fest, nachdem eine ungesicherte Verknüpfung ausgeführt wurde. Diese Option gibt darüber hinaus an, dass es sich beim Wert des Credential (DomainCredential)-Parameters um ein Computerkennwort und nicht um ein Benutzerkennwort handelt. Diese Option gilt nur, wenn die UnsecuredJoin-Option angegeben wird.
-- JoinWithNewName: Benennt den Computernamen in der neuen Domäne in den durch den NewName-Parameter angegebenen Namen um. Bei Verwendung des NewName-Parameters wird diese Option automatisch festgelegt. Diese Option ist für die Verwendung mit dem Cmdlet Rename-Computer konzipiert. Wenn Sie das Cmdlet Rename-Computer verwenden, um den Computer umzubenennen, aber den Computer nicht neu starten, um die Änderung wirksam zu machen, können Sie diesen Parameter verwenden, um den Computer mit dem neuen Namen einer Domäne hinzuzufügen.
JoinReadOnly: Verwendet ein vorhandenes Computerkonto, um den Computer mit einem schreibgeschützten Domänencontroller zu verknüpfen. Das Computerkonto muss der Liste zulässiger Kennwortreplikationsrichtlinien hinzugefügt werden, und das Kontokennwort muss vor dem Joinvorgang auf den schreibgeschützten Domänencontroller repliziert werden.
InstallInvoke: Legt die Flags create (0x2) und delete (0x4) des FJoinOptions-Parameters der JoinDomainOrWorkgroup-Methode fest. Weitere Informationen zur JoinDomainOrWorkgroup-Methode finden Sie unter JoinDomainOrWorkgroup-Methode der Win32_ComputerSystem-Klasse in der MSDN-Bibliothek. Weitere Informationen zu diesen Optionen finden Sie unter NetJoinDomain-Funktion in der MSDN Library.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Type: | JoinOptions |
| Accepted values: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OUPath
Gibt eine Organisationseinheit für das Domänenkonto an. Geben Sie den vollständigen definierten Namen der Organisationseinheit in Anführungszeichen ein. Der Standardwert ist die Standardorganisationseinheit für Computerobjekte in der Domäne.
| Type: | String |
| Aliases: | OU |
| Position: | Named |
| Default value: | The default OU for machine objects for in the domain |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Restart
Startet die Computer neu, die der Domäne oder Arbeitsgruppe hinzugefügt wurden. Ein Neustart ist häufig erforderlich, damit die Änderung wirksam wird.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Gibt den Namen eines Domänencontrollers an, der den Computer der Domäne hinzufügt. Geben Sie den Namen im Format %%amp;quot;Domänenname\Computername%%amp;quot; ein. Standardmäßig ist kein Domänencontroller angegeben.
| Type: | String |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Entfernen der Computer aus ihren aktuellen Domänen verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. %%amp;quot;User01%%amp;quot; oder %%amp;quot;Domain01\User01%%amp;quot;, oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential-Cmdlet generiertes Objekt.
Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Verwenden Sie diesen Parameter, wenn Sie Computer in eine andere Domäne verschieben. Geben Sie ein Benutzerkonto, das über die Berechtigung zum Beitreten zur neuen Domäne verfügt, mit dem Credential-Parameter an. Geben Sie ein Benutzerkonto, das über die Berechtigung zum Herstellen einer Verbindung mit einem Remotecomputer verfügt, mit dem LocalCredential-Parameter an.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Führt einen unsicheren Beitritt zur angegebenen Domäne durch.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Gibt den Namen einer Arbeitsgruppe an, der der Computer hinzugefügt wird. Der Standardwert ist %%amp;quot;WORKGROUP%%amp;quot;.
| Type: | String |
| Aliases: | WGN |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Sie können Computernamen und neue Namen an das Add-Computer Cmdlet weiterleiten.
Ausgaben
Wenn Sie den PassThru-Parameter verwenden, Add-Computer wird ein ComputerChangeInfo-Objekt zurückgegeben.
Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.
Hinweise
- In Windows PowerShell 2.0 schlägt der Serverparameter von
Add-Computerauch dann fehl, wenn der Server vorhanden ist. In Windows PowerShell 3.0 wurde die Implementierung des Server-Parameters geändert, sodass er zuverlässig funktioniert.