Add-Computer

  • Referenz
Modul:
Microsoft.PowerShell.Management

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

String

Sie können Computernamen und neue Namen an das Add-Computer Cmdlet weiterleiten.

Ausgaben

ComputerChangeInfo

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