Add-Computer
Voeg de lokale computer toe aan een domein of werkgroep.
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>]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 -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 werkgroep Werkgroep-A.
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 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
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. 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
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.
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
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. 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
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. 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:
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 $joinCredMet 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.
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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Aliases: | DomainCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Aliases: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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-Computercmdlet 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
PasswordPassde 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
UnsecuredJoinoptie is opgegeven. Wanneer u deze optie gebruikt, moet de referentie die aan de-Credentialparameter 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-Computernaam 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 |
| 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
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 |
| Aliases: | OU |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Voert een onbeveiligde join uit naar het opgegeven domein.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Hiermee geeft u de naam van een werkgroep waaraan de computers worden toegevoegd. De standaardwaarde is 'WERKGROEP'.
| Type: | String |
| Aliases: | WGN |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Invoerwaarden
U kunt computernamen en nieuwe namen doorsluisen naar de Add-Computer cmdlet.
Uitvoerwaarden
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-Computerzelfs wanneer de server aanwezig is. In Windows PowerShell 3.0 wordt de implementatie van de serverparameter gewijzigd, zodat deze betrouwbaar werkt.
Verwante koppelingen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor