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 zu einer Do Standard oder Arbeitsgruppe hinzu oder verschiebt sie von einer Do Standard zu einer anderen. 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 die Parameter "Verbose " und "PassThru ", um die Ergebnisse des Befehls abzurufen.
Beispiele
Beispiel 1: Hinzufügen eines lokalen Computers zu einer Do Standard dann den Computer neu starten
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 Vorgehensweise Standard
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose
Dieser 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 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 Do Standard 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 Vorgehensweise Standard Verwenden von 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 zu den Aufgaben verfügt Standard. 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 Do Standard
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 "UnjoinDo Standard Credential", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Aufheben der Verknüpfung mit den Computern von "Do Standard 01"Standard und dem Parameter "Credential" verfügt, um ein Benutzerkonto anzugeben, das über die Berechtigung zum Verbinden der Computer mit der Do Standard 02 do Standard 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 Do Standard 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 zum Do Standard 02 do Standard verfügt.
Beispiel 8: Hinzufügen von Computern, die in einer Datei aufgeführt sind, zu einer neuen Do Standard
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
Mit diesem Befehl werden die Computer hinzugefügt, die in der Servers.txt
Datei aufgeführt sind Standard 02 do Standard. 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 wurde.
Beispiel 9: Hinzufügen eines Computers zu einer Do Standard mithilfe vordefinierter Computeranmeldeinformationen
Dieser erste Befehl sollte von einem Administrator von einem Computer ausgeführt werden, der bereits mitglied ist StandardDomain03
:
New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
# Then this command is run from `Server02` which is not yet domain-joined:
$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
UserName = $null
Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCred
Diese Kombination von Befehlen erstellt ein neues Computerkonto mit einem vordefinierten Namen und einem temporären Verknüpfungskennwort in einer Do Standard mithilfe eines vorhandenen do Standard-verbundenen Computers. Anschließend verknüpft ein Computer mit dem vordefinierten Namen die Do Standard nur den Computernamen und das temporäre Verknüpfungskennwort verwendet. Das vordefinierte Kennwort wird nur verwendet, um den Verknüpfungsvorgang zu unterstützen und wird als Teil der normalen Computerkontoprozeduren ersetzt, nachdem der Computer die Verknüpfung abgeschlossen hat.
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 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 beruht nicht auf Windows PowerShell-Remoting. Sie können den Parameter Add-Computer
"ComputerName" auch dann verwenden, wenn Ihr Computer nicht für die Ausführung von 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. "User01" oder "Do Standard 01\User01", 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 den Parameter "UnjoinDo Standard Credential Standard, um ein Benutzerkonto anzugeben, das über die Berechtigung zum Entfernen des Computers verfügt Standard. Verwenden Sie den Parameter "LocalCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit einem Remotecomputer verfügt.
Type: | PSCredential |
Aliases: | DomainCredential |
Position: | Named |
Default value: | None |
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 der einzelnen Computer 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 Computern verfügt, die durch den Parameter ComputerName angegeben werden. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Do Standard 01\User01", 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 den Parameter "Credential", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Hinzufügen der Computer zu einer neuen Do verfügt Standard. Verwenden Sie den Parameter "UnjoinDo Standard Credential Standard um ein Benutzerkonto anzugeben, das über die Berechtigung zum Entfernen der Computer verfügt Standard.
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
Verknüpfungsvorgang an. Geben Sie Werte in einer durch Trennzeichen getrennten Zeichenfolge ein.
Zulässige Werte für diesen Parameter:
AccountCreate: Erstellt ein Do Standard Konto. Das
Add-Computer
Cmdlet erstellt automatisch ein Do Standard Konto, wenn ein Computer zu einer Do Standard hinzugefügt wird. 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. Wenn Sie ein Computerkennwort übergeben möchten, müssen Sie diese Option in Kombination mit
PasswordPass
der Option verwenden.PasswordPass: Legt das Computerkennwort auf den Wert des Parameters Credential(Do Standard Credential) fest, nachdem eine ungesicherte Verknüpfung ausgeführt wurde. Diese Option gibt auch an, dass der Wert des Parameters "Credential" (Do Standard Credential) ein Computerkennwort und kein Benutzerkennwort ist. Diese Option ist nur gültig, wenn die
UnsecuredJoin
Option angegeben wird. Bei Verwendung dieser Option müssen die für den-Credential
Parameter bereitgestellten Anmeldeinformationen einen NULL-Benutzernamen aufweisen.JoinWithNewName: Benennt den Computernamen in der neuen Do Standard in den durch den NewName-Parameter angegebenen Namen um. 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 das
Rename-Computer
Cmdlet verwenden, um den Computer umzubenennen, den Computer jedoch nicht neu zu starten, um die Änderung wirksam zu machen, können Sie diesen Parameter verwenden, um den Computer mit einem neuen Namen zu verbinden Standard.JoinReadOnly: Verwendet ein vorhandenes Computerkonto, um den Computer mit einem schreibgeschützten Do Standard controller 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 Do Standard Controller repliziert werden.
InstallInvoke: Legt die Flags zum Erstellen (0x2) und Löschen (0x4) des FJoinOptions-Parameters der JoinDo Standard OrWorkgroup-Methode fest. Weitere Informationen zur JoinDo Standard OrWorkgroup-Methode finden Sie unter JoinDo Standard OrWorkgroup-Methode der Win32_ComputerSystem-Klasse. Weitere Informationen zu diesen Optionen finden Sie unter NetJoinDo Standard-Funktion.
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: | None |
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: | None |
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. "User01" oder "Do Standard 01\User01", 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. Verwenden Sie den Parameter "Credential", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Beitritt zur neuen Do verfügt Standard. 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.
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: | None |
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
Add-Computer
fehl, auch wenn der Server vorhanden ist. In Windows PowerShell 3.0 wird die Implementierung des Serverparameters geändert, sodass sie zuverlässig funktioniert.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für