Fügt den lokalen Computer einer Domäne oder Arbeitsgruppe hinzu.
Syntax
Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>] Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "Add-Computer" fügt den lokalen Computer einer Domäne oder einer Arbeitsgruppe hinzu oder verschiebt ihn 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 eine unsichere Verknüpfung ausführen.
Mit dem Verbose-Parameter und dem PassThru-Parameter können Sie die Ergebnisse des Befehls abrufen.
Parameter
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert 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 vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
Current User Account Credentials |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-DomainName <string>
Gibt eine Domäne für das Computerkonto an. Dieser Parameter ist erforderlich.
|
Erforderlich? |
true |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-OUPath <string>
Gibt eine Organisationseinheit für das Domänenkonto an. Geben Sie den vollständigen definierten Namen der Organisationseinheit ein. Der Standardwert ist die Standardorganisationseinheit für Computerobjekte in der Domäne.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
The default OU for machine objects for in the domain |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-PassThru
Gibt die Ergebnisse des Befehls zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Server <string>
Gibt den Namen eines Domänencontrollers an, der den Computer der Domäne hinzufügt. Geben Sie den Namen im Format "Domänenname\Computername" ein. Der Standardwert ist der lokale Computer.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Unsecure
Führt eine unsichere Verknüpfung aus.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WorkGroupName <string>
Gibt den Namen einer Arbeitsgruppe für den Computer an. Wenn Sie diesen Parameter weglassen, wird der Computer einer Domäne hinzugefügt.
|
Erforderlich? |
true |
|
Position? |
3 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Objekte können nicht über die Pipeline an Add-Computer übergeben werden. |
|
Ausgaben |
Microsoft.PowerShell.Commands.ComputerChangeInfo Wenn Sie den PassThru-Parameter verwenden, wird von Add-Computer ein ComputerChangeInfo-Objekt zurückgegeben. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Beispiel 1
C:\PS>add-computer -domainname Domain01; restart-computer Beschreibung ----------- Mit diesen Befehlen wird der lokale Computer unter Verwendung der Anmeldeinformationen des aktuellen Benutzers der Domäne "Domain01" hinzugefügt. Mit dem ersten Befehl wird der Computer der Domäne hinzugefügt. Mit dem zweiten Befehl wird der Computer unter Verwendung des Cmdlets "Restart-Computer" neu gestartet, wodurch der Verknüpfungsvorgang abgeschlossen wird. Die beiden Befehle werden durch ein Semikolon (;) getrennt.
Beispiel 2
C:\PS>add-computer -workgroupname WORKGROUP-A Beschreibung ----------- Mit diesem Befehl wird der lokale Computer der Arbeitsgruppe "Workgroup-A" hinzugefügt.
Beispiel 3
C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose Beschreibung ----------- Dieser Befehl fügt den lokalen Computer unter Verwendung des Domänencontrollers "Domain01\DC01" der Domäne "Domain01" hinzu. Der Befehl ruft mit dem PassThru-Parameter und dem Verbose-Parameter ausführliche Informationen zu den Ergebnissen des Befehls ab.
Beispiel 4
C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com Beschreibung ----------- Dieser Befehl fügt die Computer "Server01" und "Server02" der Domäne "Domain02" hinzu. Dabei wird mit dem Befehl "OUPath" die Organisationseinheit für die neuen Konten angegeben.
Beispiel 5
C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru Beschreibung ----------- Dieser Befehl fügt den lokalen Computer mit den Anmeldeinformationen eines Domänenadministrators der Domäne "Domain02" hinzu. Der Befehl generiert mithilfe des PassThru-Parameters einen kurzen Bericht über die Ergebnisse des Befehls.
Siehe auch