Add-Computer
Lägg till den lokala datorn i en domän eller arbetsgrupp.
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
Cmdleten Add-Computer lägger till den lokala datorn eller fjärrdatorerna i en domän eller arbetsgrupp, eller flyttar dem från en domän till en annan. Det skapar också ett domänkonto om datorn läggs till i domänen utan ett konto.
Du kan använda parametrarna för den här cmdleten för att ange en organisationsenhet (OU) och domänkontrollant eller för att utföra en oskyddad koppling.
Om du vill hämta resultatet av kommandot använder du parametrarna Verbose och PassThru .
Exempel
Exempel 1: Lägg till en lokal dator i en domän och starta sedan om datorn
Add-Computer -DomainName Domain01 -RestartDet här kommandot lägger till den lokala datorn i domänen Domain01 och startar sedan om datorn för att göra ändringen effektiv.
Exempel 2: Lägga till en lokal dator i en arbetsgrupp
Add-Computer -WorkgroupName WORKGROUP-ADet här kommandot lägger till den lokala datorn i arbetsgruppen Workgroup-A.
Exempel 3: Lägga till en lokal dator i en domän
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseDet här kommandot lägger till den lokala datorn i domänen Domain01 med domänkontrollanten Domain01\DC01.
Kommandot använder parametrarna PassThru och Verbose för att få detaljerad information om resultatet av kommandot.
Exempel 4: Lägg till en lokal dator i en domän med OUPath-parametern
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"Det här kommandot lägger till den lokala datorn i domänen Domain02. Den använder OUPath-parametern för att ange organisationsenheten för de nya kontona.
Exempel 5: Lägga till en lokal dator i en domän med autentiseringsuppgifter
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceDet här kommandot lägger till Server01-datorn i domänen Domain02. Den använder parametern LocalCredential för att ange ett användarkonto som har behörighet att ansluta till Server01-datorn. Den använder parametern Credential för att ange ett användarkonto som har behörighet att ansluta datorer till domänen. Den använder parametern Starta om för att starta om datorn när kopplingsåtgärden har slutförts och force-parametern för att förhindra bekräftelsemeddelanden från användaren.
Exempel 6: Flytta en grupp datorer till en ny domän
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartDet här kommandot flyttar datorerna Server01 och Server02 och den lokala datorn från Domain01 till Domain02.
Den använder parametern LocalCredential för att ange ett användarkonto som har behörighet att ansluta till de tre berörda datorerna. Den använder parametern UnjoinDomainCredential för att ange ett användarkonto som har behörighet att koppla från datorerna från domänen Domain01 och parametern Credential för att ange ett användarkonto som har behörighet att ansluta datorerna till domänen Domain02. Den använder parametern Starta om för att starta om alla tre datorerna när flytten är klar.
Exempel 7: Flytta en dator till en ny domän och ändra namnet på datorn
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartDet här kommandot flyttar Server01-datorn till Domain02 och ändrar datornamnet till Server044.
Kommandot använder den aktuella användarens autentiseringsuppgifter för att ansluta till Server01-datorn och koppla bort den från den aktuella domänen. Den använder parametern Credential för att ange ett användarkonto som har behörighet att ansluta datorn till domänen Domain02.
Exempel 8: Lägg till datorer som anges i en fil i en ny domän
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartDet här kommandot lägger till datorerna som visas i filen i Servers.txt domänen Domain02. Den använder parametern Alternativ för att ange alternativet Win9xUpgrade . Parametern Starta om startar om alla nyligen tillagda datorer när kopplingsåtgärden har slutförts.
Exempel 9: Lägga till en dator i en domän med fördefinierade datorautentiseringsuppgifter
Det första kommandot ska köras av en administratör från en dator som redan är ansluten till domänen 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 $joinCredDen här kombinationen av kommandon skapar ett nytt datorkonto med ett fördefinierat namn och ett tillfälligt kopplingslösenord i en domän med hjälp av en befintlig domänansluten dator. Separat ansluter en dator med det fördefinierade namnet domänen med endast datornamnet och det tillfälliga anslutningslösenordet. Det fördefinierade lösenordet används endast för att stödja kopplingsåtgärden och ersätts som en del av normala procedurer för datorkonton när datorn har slutfört anslutningen.
Parametrar
-ComputerName
Anger vilka datorer som ska läggas till i en domän eller arbetsgrupp. Standard är den lokala datorn.
Ange NetBIOS-namnet, en IP-adress (Internet Protocol) eller ett fullständigt kvalificerat domännamn för var och en av fjärrdatorerna. Om du vill ange den lokala datorn skriver du datornamnet, en punkt (.) eller "localhost".
Den här parametern förlitar sig inte på Windows PowerShell-fjärrkommunikation. Du kan använda parametern Add-Computer ComputerName för även om datorn inte är konfigurerad för att köra fjärrkommandon.
Den här parametern introduceras i Windows PowerShell 3.0.
| Typ: | String[] |
| Position: | Named |
| Standardvärde: | Local computer |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Credential
Anger ett användarkonto som har behörighet att ansluta datorerna till en ny domän. Standard är den aktuella användaren.
Ange ett användarnamn, till exempel "User01" eller "Domain01\User01", eller ange ett PSCredential-objekt, till exempel ett som genereras av cmdletenGet-Credential. Om du skriver ett användarnamn uppmanas du att ange ett lösenord.
Om du vill ange ett användarkonto som har behörighet att ta bort datorn från den aktuella domänen använder du parametern UnjoinDomainCredential . Om du vill ange ett användarkonto som har behörighet att ansluta till en fjärrdator använder du parametern LocalCredential .
| Typ: | PSCredential |
| Alias: | DomainCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DomainName
Anger den domän som datorerna läggs till i. Den här parametern krävs när datorerna läggs till i en domän.
| Typ: | String |
| Alias: | DN, Domain |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Force
Undertrycker uppmaningen om användarbekräftelse. Utan den här parametern Add-Computer måste du bekräfta tillägget av varje dator.
Den här parametern introduceras i Windows PowerShell 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-LocalCredential
Anger ett användarkonto som har behörighet att ansluta till de datorer som anges av parametern ComputerName . Standard är den aktuella användaren.
Ange ett användarnamn, till exempel "User01" eller "Domain01\User01", eller ange ett PSCredential-objekt, till exempel ett som genereras av cmdletenGet-Credential. Om du skriver ett användarnamn uppmanas du att ange ett lösenord.
Om du vill ange ett användarkonto som har behörighet att lägga till datorerna i en ny domän använder du parametern Credential . Om du vill ange ett användarkonto som har behörighet att ta bort datorerna från den aktuella domänen använder du parametern UnjoinDomainCredential .
Den här parametern introduceras i Windows PowerShell 3.0.
| Typ: | PSCredential |
| Position: | Named |
| Standardvärde: | Current user |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-NewName
Anger ett nytt namn för datorn i den nya domänen. Den här parametern är endast giltig när en dator läggs till eller flyttas.
Den här parametern introduceras i Windows PowerShell 3.0.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Options
Anger avancerade alternativ för kopplingsåtgärden Add-Computer . Ange ett eller flera värden i en kommaavgränsad sträng.
De acceptabla värdena för den här parametern är:
KontoSkapa: Skapar ett domänkonto. Cmdleten
Add-Computerskapar automatiskt ett domänkonto när en dator läggs till i en domän. Det här alternativet ingår för fullständighet.Win9XUpgrade: Anger att kopplingsåtgärden är en del av en uppgradering av Windows-operativsystemet.
UnsecuredJoin: Utför en oskyddad koppling. Om du vill begära en oskyddad koppling använder du parametern Unsecure eller det här alternativet. Om du vill skicka ett datorlösenord måste du använda det här alternativet i kombination med
PasswordPassalternativet.PasswordPass: Anger datorlösenordet till värdet för parametern Credential (DomainCredential) efter att ha utfört en oskyddad koppling. Det här alternativet anger också att värdet för parametern Autentiseringsuppgifter (DomainCredential) är ett datorlösenord, inte ett användarlösenord. Det här alternativet är endast giltigt när alternativet
UnsecuredJoinhar angetts. När du använder det här alternativet måste autentiseringsuppgifterna som anges för parametern-Credentialha ett null-användarnamn.JoinWithNewName: Byter namn på datornamnet i den nya domänen till det namn som anges av parametern NewName . När du använder parametern NewName anges det här alternativet automatiskt. Det här alternativet är utformat för att användas med cmdleten Rename-Computer. Om du använder cmdleten
Rename-Computerför att byta namn på datorn, men inte startar om datorn för att göra ändringen effektiv, kan du använda den här parametern för att ansluta datorn till en domän med dess nya namn.JoinReadOnly: Använder ett befintligt datorkonto för att ansluta datorn till en skrivskyddad domänkontrollant. Datorkontot måste läggas till i den tillåtna listan för lösenordsreplikeringsprincip och kontolösenordet måste replikeras till den skrivskyddade domänkontrollanten innan anslutningsåtgärden.
InstallInvoke: Anger flaggorna create (0x2) och delete (0x4) för parametern FJoinOptions för metoden JoinDomainOrWorkgroup . Mer information om metoden JoinDomainOrWorkgroup finns i Metoden JoinDomainOrWorkgroup i klassen Win32_ComputerSystem. Mer information om de här alternativen finns i Funktionen NetJoinDomain.
Den här parametern introducerades i Windows PowerShell 3.0.
| Typ: | JoinOptions |
| Godkända värden: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-OUPath
Anger en organisationsenhet (OU) för domänkontot. Ange det fullständiga unika namnet på organisationsenheten inom citattecken. Standardvärdet är standard-OU för datorobjekt i domänen.
| Typ: | String |
| Alias: | OU |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-PassThru
Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Restart
Startar om datorerna som lades till i domänen eller arbetsgruppen. En omstart krävs ofta för att göra ändringen effektiv.
Den här parametern introduceras i Windows PowerShell 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Server
Anger namnet på en domänkontrollant som lägger till datorn i domänen. Ange namnet i formatet DomainName\ComputerName. Som standard anges ingen domänkontrollant.
| Typ: | String |
| Alias: | DC |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UnjoinDomainCredential
Anger ett användarkonto som har behörighet att ta bort datorerna från sina aktuella domäner. Standard är den aktuella användaren.
Ange ett användarnamn, till exempel "User01" eller "Domain01\User01", eller ange ett PSCredential-objekt, till exempel ett som genereras av cmdletenGet-Credential. Om du skriver ett användarnamn uppmanas du att ange ett lösenord.
Använd den här parametern när du flyttar datorer till en annan domän. Om du vill ange ett användarkonto som har behörighet att ansluta till den nya domänen använder du parametern Credential . Om du vill ange ett användarkonto som har behörighet att ansluta till en fjärrdator använder du parametern LocalCredential .
Den här parametern introduceras i Windows PowerShell 3.0.
| Typ: | PSCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Unsecure
Utför en osäker koppling till den angivna domänen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WorkgroupName
Anger namnet på en arbetsgrupp som datorerna läggs till i. Standardvärdet är "WORKGROUP".
| Typ: | String |
| Alias: | WGN |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
Du kan skicka namn och nya namn till cmdleten Add-Computer .
Utdata
När du använder parametern Add-Computer PassThru returnerar ett ComputerChangeInfo-objekt.
Annars genererar den här cmdleten inga utdata.
Kommentarer
- I Windows PowerShell 2.0 misslyckas serverparametern
Add-Computerför även när servern finns. I Windows PowerShell 3.0 ändras implementeringen av serverparametern så att den fungerar tillförlitligt.
