Add-Computer
Fügt den lokalen Computer einer Domäne oder Arbeitsgruppe hinzu.
Syntax
Domain (Standard)
Add-Computer
[-DomainName] <String>
-Credential <PSCredential>
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Workgroup
Add-Computer
[-WorkgroupName] <String>
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Add-Computer Cmdlet fügt den lokalen Computer oder Remotecomputer zu 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.
Verwenden Sie zum Abrufen der Ergebnisse des Befehls die Parameter Verbose und PassThru.
Beispiele
Beispiel 1: Hinzufügen eines lokalen Computers zu einer Domäne und starten dann den Computer neu
Add-Computer -DomainName Domain01 -Restart
Mit 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-A
Mit 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 -Verbose
Mit diesem Befehl wird der lokale Computer mithilfe des Domänencontrollers Domain01\DC01 der Domäne Domain01 hinzugefügt.
Der Befehl verwendet die Parameter "PassThru " und "Verbose ", um detaillierte Informationen zu den Ergebnissen des Befehls zu erhalten.
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 mit Anmeldeinformationen
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force
Mit diesem Befehl wird der Computer %%amp;quot;Server01%%amp;quot; der Domäne %%amp;quot;Domain02%%amp;quot; hinzugefügt. Er verwendet den Parameter "LocalCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit dem Server01-Computer verfügt. Er verwendet den Parameter "Credential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Beitreten von Computern zur Domäne verfügt. Er verwendet den Parameter "Restart ", um den Computer neu zu starten, nachdem der Verknüpfungsvorgang abgeschlossen wurde, und der Parameter "Force ", um Bestätigungsmeldungen des Benutzers zu unterdrücken.
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 -Restart
Mit 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.
Er verwendet den Parameter "LocalCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit den drei betroffenen Computern verfügt. Er verwendet den Parameter "UnjoinDomainCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Aufheben der Verknüpfung mit den Computern aus der Domäne "Domain01" und dem Parameter "Credential " verfügt, um ein Benutzerkonto anzugeben, das über die Berechtigung zum Beitritt zu den Computern zur Domäne 02 verfügt. Er verwendet den Parameter "Restart ", um alle drei Computer neu zu starten, nachdem die Verschiebung abgeschlossen ist.
Beispiel 7: Verschieben eines Computers in eine neue Domäne und Ändern des Namens des Computers
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart
Mit 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 Parameter "Credential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Beitritt zum Computer zur Domäne "Domain02" verfügt.
Beispiel 8: Hinzufügen von Computern in einer Datei zu einer neuen Domäne
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
Mit diesem Befehl werden die Computer, die in der Datei Servers.txt aufgeführt sind, der Domäne Domain02 hinzugefügt. Er verwendet den Parameter "Options ", um die Win9xUpgrade-Option anzugeben. Der Parameter Restart startet alle neu hinzugefügten Computer neu, nachdem der Verknüpfungsvorgang abgeschlossen ist.
Parameter
-ComputerName
Gibt die einer Domäne oder Arbeitsgruppe hinzuzufügenden Computer an. Der Standardwert ist der lokale Computer.
Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen der einzelnen Remotecomputer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder "localhost" ein.
Dieser Parameter basiert nicht auf Windows PowerShell-Remoting.
Sie können den ComputerName Parameter von Add-Computer verwenden, auch wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | Local computer |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Hinzufügen der Computer zu einer neuen Domäne verfügt. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential--Objekt ein, z. B. ein objekt, das vom Cmdlet Get-Credential generiert wurde.
Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Um ein Benutzerkonto anzugeben, das über die Berechtigung zum Entfernen des Computers aus seiner aktuellen Domäne verfügt, verwenden Sie den Parameter UnjoinDomainCredential. Verwenden Sie den Parameter "LocalCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit einem Remotecomputer verfügt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | Current User Account Credentials |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | DomainCredential |
Parametersätze
Workgroup
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | DN, Domäne |
Parametersätze
Domain
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Unterdrückt die Bestätigungsaufforderung.
Ohne diesen Parameter Add-Computer müssen Sie das Hinzufügen der einzelnen Computer bestätigen.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LocalCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit den Computern verfügt, die durch den Parameter ComputerName angegeben werden. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential--Objekt ein, z. B. ein objekt, das vom Cmdlet Get-Credential generiert wurde.
Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Um ein Benutzerkonto anzugeben, das über die Berechtigung zum Hinzufügen der Computer zu einer neuen Domäne verfügt, verwenden Sie den Parameter "Credential ". Um ein Benutzerkonto anzugeben, das über die Berechtigung zum Entfernen der Computer aus der aktuellen Domäne verfügt, verwenden Sie den Parameter "UnjoinDomainCredential" .
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | Current user |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Options
Gibt erweiterte Optionen für den Verknüpfungsvorgang "Computer hinzufügen" an. Geben Sie Werte in einer durch Trennzeichen getrennten Zeichenfolge ein.
Die zulässigen Werte für diesen Parameter sind:
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 für Vollständigkeit enthalten.
Win9XUpgrade: Gibt an, dass der Verknüpfungsvorgang Teil eines Windows-Betriebssystemupgrades ist.
UnsecuredJoin: Führt eine ungesicherte Verknüpfung aus. Um eine ungesicherte Verknüpfung anzufordern, verwenden Sie den Unsecure-Parameter 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 auch an, dass der Wert des Parameters "Credential " (DomainCredential) ein Computerkennwort und kein Benutzerkennwort ist. Diese Option ist nur gültig, wenn die Option UnsecuredJoin angegeben ist.
-- JoinWithNewName: Benennt den Computernamen in der neuen Domäne in den Namen um, der durch den NewName-Parameter angegeben wird. Wenn Sie den Parameter NewName verwenden, wird diese Option automatisch festgelegt. Diese Option ist für die Verwendung mit dem Cmdlet Rename-Computer konzipiert. Wenn Sie den Computer mit dem Cmdlet Rename-Computer umbenennen, den Computer aber nicht neu starten, um die Änderung wirksam zu machen, können Sie diesen Parameter verwenden, um den Computer mit seinem neuen Namen einer Domäne hinzuzufügen.
JoinReadOnly: Verwendet ein vorhandenes Computerkonto, um den Computer mit einem schreibgeschützten Domänencontroller zu verbinden. Das Computerkonto muss der Liste der zulässigen Kennwortreplikationsrichtlinie hinzugefügt werden, und das Kontokennwort muss vor dem Verknüpfungsvorgang 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 Library. Weitere Informationen zu diesen Optionen finden Sie unter NetJoinDomain-Funktion in der MSDN Library.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | JoinOptions |
| Standardwert: | None |
| Zulässige Werte: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Domain
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OUPath
Gibt eine Organisationseinheit (OU) für das Domänenkonto an. Geben Sie den vollständigen Distinguished Name der OU in Anführungszeichen ein. Der Standardwert ist die Standard-OU für Computerobjekte in der Domäne.
Parametereigenschaften
| Typ: | String |
| Standardwert: | The default OU for machine objects for in the domain |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | OE |
Parametersätze
Domain
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Restart
Startet die Computer neu, die der Domäne oder Arbeitsgruppe hinzugefügt wurden. Ein Neustart ist häufig erforderlich, um die Änderung wirksam zu machen.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | SL |
Parametersätze
Domain
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UnjoinDomainCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Entfernen der Computer aus ihren aktuellen Domänen verfügt. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential--Objekt ein, z. B. ein objekt, das vom Cmdlet Get-Credential generiert wurde.
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. Verwenden Sie den Parameter "Credential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Beitritt zur neuen Domäne verfügt. Verwenden Sie den Parameter "LocalCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit einem Remotecomputer verfügt.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Domain
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Unsecure
Führt einen unsicheren Beitritt zur angegebenen Domäne durch.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Domain
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WorkgroupName
Gibt den Namen einer Arbeitsgruppe an, der der Computer hinzugefügt wird. Der Standardwert ist %%amp;quot;WORKGROUP%%amp;quot;.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | WGN |
Parametersätze
Workgroup
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
Sie können Computernamen und neue Namen an das Add-Computer Cmdlet weiterleiten.
Ausgaben
ComputerChangeInfo
Wenn Sie den PassThru--Parameter verwenden, gibt Add-Computer ein ComputerChangeInfo--Objekt zurück.
Andernfalls generiert dieses Cmdlet keine Ausgabe.
Hinweise
- In Windows PowerShell 2.0 schlägt der Serverparameter
Add-Computerfehl, auch wenn der Server vorhanden ist. In Windows PowerShell 3.0 wird die Implementierung des Serverparameters geändert, sodass sie zuverlässig funktioniert.