Add-Computer
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.
Als u de resultaten van de opdracht wilt ophalen, gebruikt u de parameters Uitgebreide en PassThru.
Voorbeelden
Voorbeeld 1: Voeg een lokale computer toe aan een domein en start de computer opnieuw op
Add-Computer -DomainName Domain01 -RestartMet 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-AMet deze opdracht wordt de lokale computer toegevoegd aan de Workgroup-A werkgroep.
Voorbeeld 3: Een lokale computer toevoegen aan een domein
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseMet deze opdracht wordt de lokale computer toegevoegd aan het domein Domain01 met behulp van de domeincontroller Domain01\DC01.
De opdracht gebruikt de PassThru- en uitgebreide parameters om gedetailleerde informatie over de resultaten van de opdracht op te halen.
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
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceMet deze opdracht wordt de Server01-computer toegevoegd aan het domein Domain02. Hierbij wordt de parameter LocalCredential gebruikt om een gebruikersaccount op te geven dat gemachtigd is om verbinding te maken met de Server01-computer. Hierbij wordt de parameter Credential gebruikt om een gebruikersaccount op te geven dat gemachtigd is om computers aan het domein toe te voegen. De parameter Start opnieuw op om de computer opnieuw op te starten nadat de joinbewerking is voltooid en de parameter Forceren om bevestigingsberichten van gebruikers te onderdrukken.
Voorbeeld 6: Een groep computers verplaatsen naar een nieuw domein
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartMet deze opdracht worden de Server01- en Server02-computers en de lokale computer verplaatst van Domain01 naar Domain02.
Hierbij wordt de parameter LocalCredential 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 los te koppelen van het domein Domain01 en de parameter Credential 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
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartMet 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. Hierbij wordt de parameter Credential 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
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartMet deze opdracht worden de computers die in het Servers.txt-bestand worden vermeld, toegevoegd aan het domein Domain02. De parameter Options wordt 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.
Parameters
-ComputerName
Hiermee geeft u de computers die moeten worden toegevoegd aan een domein of werkgroep. De standaardwaarde is 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 parameter ComputerName van Add-Computer gebruiken, 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
U wordt 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. De standaardwaarde is 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: | Current User Account Credentials |
| 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 moet u Add-Computer 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. De standaardwaarde is 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 Credential. 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 acceptabele waarden voor deze parameter zijn:
AccountCreate: Hiermee maakt u een domeinaccount. Met de cmdlet Add-Computer 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 joinbewerking deel uitmaakt van een upgrade van een Windows-besturingssysteem.
UnsecuredJoin: voert een onbeveiligde join uit. Als u een onbeveiligde join wilt aanvragen, gebruikt u de parameter Onbeveiligde of deze optie.
PasswordPass: hiermee stelt u het computerwachtwoord in op de waarde van de parameter Credential(DomainCredential) nadat u een onbeveiligde join hebt uitgevoerd. 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 optie UnsecuredJoin is opgegeven.
-- 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 Rename-Computer cmdlet. Als u de cmdlet Rename-Computer gebruikt om de 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 voor meer informatie over de methode JoinDomainOrWorkgroupJoinDomainOrWorkgroup van de Win32_ComputerSystem-klasse in de MSDN-bibliotheek. Zie NetJoinDomain-functie in de MSDN-bibliotheek 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: | The default OU for machine objects for in the domain |
| 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: | False |
| 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. De standaardwaarde is 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 Credential. 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: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. 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
U kunt computernamen en nieuwe namen doorsluisen naar de Add-Computer Cmdlet.
Uitvoerwaarden
Wanneer u de parameter PassThru gebruikt, retourneert Add-Computer een ComputerChangeInfo--object.
Anders genereert deze cmdlet geen uitvoer.
Notities
- In Windows PowerShell 2.0 mislukt de parameter Server van
Add-Computerzelfs wanneer de server aanwezig is. In Windows PowerShell 3.0 wordt de implementatie van de parameter Server gewijzigd, zodat deze betrouwbaar werkt.