Delen via

Add-Computer

  • Referentie
Module:
Microsoft.PowerShell.Management

Voeg de lokale computer toe aan een domein of werkgroep.

Syntaxis

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>]

Description

De Add-Computer cmdlet voegt de lokale computer of externe computers toe aan een domein of werkgroep of verplaatst ze van het ene naar het andere domein. Er wordt ook een domeinaccount gemaakt als de computer zonder account aan het domein wordt toegevoegd.

U kunt de parameters van deze cmdlet gebruiken om een organisatie-eenheid (OE) en domeincontroller op te geven of om een onbeveiligde join uit te voeren.

Gebruik de parameters Uitgebreid en PassThru om de resultaten van de opdracht op te halen.

Voorbeelden

Voorbeeld 1: Voeg een lokale computer toe aan een domein en start de computer opnieuw op

Add-Computer -DomainName Domain01 -Restart

Met deze opdracht wordt de lokale computer toegevoegd aan het domein Domain01 en wordt de computer opnieuw opgestart om de wijziging effectief te maken.

Voorbeeld 2: Een lokale computer toevoegen aan een werkgroep

Add-Computer -WorkgroupName WORKGROUP-A

Met deze opdracht wordt de lokale computer toegevoegd aan de werkgroep Werkgroep-A.

Voorbeeld 3: Een lokale computer toevoegen aan een domein

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

Met deze opdracht wordt de lokale computer aan het domein Domain01 toegevoegd met behulp van de Domain01\DC01 domeincontroller.

De opdracht maakt gebruik van de parameters PassThru en Uitgebreide informatie over de resultaten van de opdracht.

Voorbeeld 4: Een lokale computer toevoegen aan een domein met behulp van de OEPath-parameter

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Met deze opdracht wordt de lokale computer toegevoegd aan het domein Domain02. Hierbij wordt de OUPath-parameter gebruikt om de organisatie-eenheid voor de nieuwe accounts op te geven.

Voorbeeld 5: Een lokale computer toevoegen aan een domein met behulp van referenties

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

Met deze opdracht wordt de Server01-computer toegevoegd aan het domein Domain02. De parameter LocalCredential wordt gebruikt om een gebruikersaccount op te geven dat gemachtigd is om verbinding te maken met de Server01-computer. Hierbij wordt de referentieparameter gebruikt om een gebruikersaccount op te geven dat gemachtigd is om computers aan het domein toe te voegen. De parameter Opnieuw opstarten wordt gebruikt om de computer opnieuw op te starten nadat de joinbewerking is voltooid en de parameter Force om bevestigingsberichten van gebruikers te onderdrukken.

Voorbeeld 6: Een groep computers verplaatsen naar een nieuw domein

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Met deze opdracht worden de Server01- en Server02-computers en de lokale computer verplaatst van Domain01 naar Domain02.

De parameter LocalCredential wordt gebruikt om een gebruikersaccount op te geven dat gemachtigd is om verbinding te maken met de drie betrokken computers. Hierbij wordt de parameter UnjoinDomainCredential gebruikt om een gebruikersaccount op te geven dat gemachtigd is om de computers van het domein Domain01 ongedaan te maken en de parameter Referentie om een gebruikersaccount op te geven dat gemachtigd is om de computers aan het domein Domain02 toe te voegen. De parameter Opnieuw opstarten wordt gebruikt om alle drie de computers opnieuw op te starten nadat de verplaatsing is voltooid.

Voorbeeld 7: Een computer verplaatsen naar een nieuw domein en de naam van de computer wijzigen

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Met deze opdracht wordt de Server01-computer verplaatst naar het domein02 en wordt de computernaam gewijzigd in Server044.

De opdracht gebruikt de referentie van de huidige gebruiker om verbinding te maken met de Server01-computer en ontkoppel deze vanuit het huidige domein. De parameter Referentie wordt gebruikt om een gebruikersaccount op te geven dat gemachtigd is om de computer aan het domein Domain02 toe te voegen.

Voorbeeld 8: Computers in een bestand toevoegen aan een nieuw domein

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

Met deze opdracht worden de computers die in het Servers.txt bestand worden vermeld, toegevoegd aan het domein Domain02. Hierbij wordt de parameter Opties gebruikt om de optie Win9xUpgrade op te geven. Met de parameter Opnieuw opstarten worden alle zojuist toegevoegde computers opnieuw opgestart nadat de joinbewerking is voltooid.

Voorbeeld 9: Een computer toevoegen aan een domein met behulp van vooraf gedefinieerde computerreferenties

Deze eerste opdracht moet worden uitgevoerd door een beheerder vanaf een computer die al lid is van een domein Domain03:

$newADComputerSplat = @{
    Name = "Server02"
    AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat

# 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]
})
$addComputerSplat = @{
    DomainName = "Domain03"
    Options = 'UnsecuredJoin', 'PasswordPass'
    Credential = $joinCred
}
Add-Computer @addComputerSplat

Met deze combinatie van opdrachten maakt u een nieuw computeraccount met een vooraf gedefinieerde naam en een tijdelijk joinwachtwoord in een domein met behulp van een bestaande computer die lid is van een domein. Vervolgens voegt een computer met de vooraf gedefinieerde naam toe aan het domein met alleen de computernaam en het tijdelijke joinwachtwoord. Het vooraf gedefinieerde wachtwoord wordt alleen gebruikt ter ondersteuning van de joinbewerking en wordt vervangen als onderdeel van normale computeraccountprocedures nadat de computer de join heeft voltooid.

Voorbeeld 10: Een computer toevoegen aan een domein met een nieuwe naam

Als u deze combinatie van opdrachten gebruikt, worden meerdere herstarts en meerdere schrijfbewerkingen naar Active Directory-schrijfbewerkingen voor hetzelfde object voorkomen wanneer de computer het domein met de nieuwe naam koppelt.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

Parameters

-ComputerName

Hiermee geeft u de computers die moeten worden toegevoegd aan een domein of werkgroep. Standaard is dit de lokale computer.

Typ de NetBIOS-naam, een IP-adres (Internet Protocol) of een volledig gekwalificeerde domeinnaam van elk van de externe computers. Als u de lokale computer wilt opgeven, typt u de computernaam, een punt (.) of localhost.

Deze parameter is niet afhankelijk van externe communicatie met Windows PowerShell. U kunt de computernaamparameter gebruiken, Add-Computer zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.

Deze parameter wordt geïntroduceerd in Windows PowerShell 3.0.

Type:String[]
Position:Named
Default value:Local computer
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om de computers aan een nieuw domein toe te voegen. Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals 'User01' of 'Domain01\User01', of voer een PSCredential-object in, zoals een object dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Als u een gebruikersaccount wilt opgeven dat gemachtigd is om de computer uit het huidige domein te verwijderen, gebruikt u de parameter UnjoinDomainCredential . Als u een gebruikersaccount wilt opgeven dat gemachtigd is om verbinding te maken met een externe computer, gebruikt u de parameter LocalCredential .

Type:PSCredential
Aliassen:DomainCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DomainName

Hiermee geeft u het domein waaraan de computers worden toegevoegd. Deze parameter is vereist bij het toevoegen van de computers aan een domein.

Type:String
Aliassen:DN, Domain
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Onderdrukt de bevestigingsprompt van de gebruiker. Zonder deze parameter Add-Computer moet u de toevoeging van elke computer bevestigen.

Deze parameter wordt geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LocalCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om verbinding te maken met de computers die zijn opgegeven door de parameter ComputerName . Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals 'User01' of 'Domain01\User01', of voer een PSCredential-object in, zoals een object dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Als u een gebruikersaccount wilt opgeven dat gemachtigd is om de computers toe te voegen aan een nieuw domein, gebruikt u de parameter Referentie . Als u een gebruikersaccount wilt opgeven dat gemachtigd is om de computers uit het huidige domein te verwijderen, gebruikt u de parameter UnjoinDomainCredential .

Deze parameter wordt geïntroduceerd in Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:Current user
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NewName

Hiermee geeft u een nieuwe naam voor de computer in het nieuwe domein. Deze parameter is alleen geldig wanneer één computer wordt toegevoegd of verplaatst.

Deze parameter wordt geïntroduceerd in Windows PowerShell 3.0.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Options

Hiermee geeft u geavanceerde opties voor de Add-Computer join-bewerking. Voer een of meer waarden in een door komma's gescheiden tekenreeks in.

De aanvaardbare waarden voor deze parameter zijn:

  • AccountCreate: Hiermee maakt u een domeinaccount. Met de Add-Computer cmdlet wordt automatisch een domeinaccount gemaakt wanneer er een computer aan een domein wordt toegevoegd. Deze optie is opgenomen voor volledigheid.

  • Win9XUpgrade: Geeft aan dat de join-bewerking deel uitmaakt van een upgrade van het Windows-besturingssysteem.

  • UnsecuredJoin: voert een onbeveiligde join uit. Als u een onbeveiligde join wilt aanvragen, gebruikt u de parameter Onbeveiligd of deze optie. Als u een computerwachtwoord wilt doorgeven, moet u deze optie in combinatie met PasswordPass de optie gebruiken.

  • PasswordPass: stelt het computerwachtwoord in op de waarde van de parameter Credential (DomainCredential) na het uitvoeren van een onbeveiligde join. Deze optie geeft ook aan dat de waarde van de parameter Credential (DomainCredential) een computerwachtwoord is, niet een gebruikerswachtwoord. Deze optie is alleen geldig wanneer de UnsecuredJoin optie is opgegeven. Wanneer u deze optie gebruikt, moet de referentie die aan de -Credential parameter is opgegeven, een null-gebruikersnaam hebben.

  • JoinWithNewName: wijzigt de naam van de computer in het nieuwe domein in de naam die is opgegeven door de parameter NewName . Wanneer u de parameter NewName gebruikt, wordt deze optie automatisch ingesteld. Deze optie is ontworpen voor gebruik met de cmdlet Rename-Computer. Als u de cmdlet gebruikt om de Rename-Computer naam van de computer te wijzigen, maar de computer niet opnieuw opstart om de wijziging effectief te maken, kunt u deze parameter gebruiken om de computer toe te voegen aan een domein met de nieuwe naam.

  • JoinReadOnly: gebruikt een bestaand computeraccount om de computer aan een alleen-lezen domeincontroller toe te voegen. Het computeraccount moet worden toegevoegd aan de lijst met toegestane wachtwoorden voor wachtwoordreplicatiebeleid en het accountwachtwoord moet worden gerepliceerd naar de alleen-lezen domeincontroller voordat de joinbewerking wordt uitgevoerd.

  • InstallInvoke: Hiermee stelt u de markeringen voor maken (0x2) en verwijderen (0x4) van de FJoinOptions-parameter van de methode JoinDomainOrWorkgroup in. Zie de methode JoinDomainOrWorkgroup van de Win32_ComputerSystem-klasse voor meer informatie over de methode JoinDomainOrWorkgroup. Zie de functie NetJoinDomain voor meer informatie over deze opties.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:JoinOptions
Geaccepteerde waarden:AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OUPath

Hiermee geeft u een organisatie-eenheid (OE) voor het domeinaccount. Voer de volledige DN-naam van de organisatie-eenheid in tussen aanhalingstekens. De standaardwaarde is de standaard-OE voor machineobjecten in het domein.

Type:String
Aliassen:OU
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Restart

Start de computers opnieuw op die zijn toegevoegd aan het domein of de werkgroep. Een herstart is vaak vereist om de wijziging effectief te maken.

Deze parameter wordt geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Server

Hiermee geeft u de naam van een domeincontroller die de computer aan het domein toevoegt. Voer de naam in de indeling DomainName\ComputerName in. Standaard is er geen domeincontroller opgegeven.

Type:String
Aliassen:DC
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UnjoinDomainCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om de computers uit hun huidige domeinen te verwijderen. Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals 'User01' of 'Domain01\User01', of voer een PSCredential-object in, zoals een object dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Gebruik deze parameter wanneer u computers naar een ander domein verplaatst. Als u een gebruikersaccount wilt opgeven dat gemachtigd is om lid te worden van het nieuwe domein, gebruikt u de parameter Referentie . Als u een gebruikersaccount wilt opgeven dat gemachtigd is om verbinding te maken met een externe computer, gebruikt u de parameter LocalCredential .

Deze parameter wordt geïntroduceerd in Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Unsecure

Voert een onbeveiligde join uit naar het opgegeven domein.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WorkgroupName

Hiermee geeft u de naam van een werkgroep waaraan de computers worden toegevoegd. De standaardwaarde is 'WERKGROEP'.

Type:String
Aliassen:WGN
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt computernamen en nieuwe namen doorsluisen naar de Add-Computer cmdlet.

Uitvoerwaarden

ComputerChangeInfo

Wanneer u de parameter PassThru gebruikt, Add-Computer wordt een ComputerChangeInfo-object geretourneerd. Anders genereert deze cmdlet geen uitvoer.

Notities

  • In Windows PowerShell 2.0 mislukt de serverparameter Add-Computer zelfs wanneer de server aanwezig is. In Windows PowerShell 3.0 wordt de implementatie van de serverparameter gewijzigd, zodat deze betrouwbaar werkt.