Add-Computer

  • Referens
Modul:
Microsoft.PowerShell.Management

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.

Använd parametrarna Verbose och PassThru för att hämta resultatet av kommandot.

Exempel

Exempel 1: Lägg till en lokal dator i en domän och starta sedan om datorn

Add-Computer -DomainName Domain01 -Restart

Det 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-A

Det här kommandot lägger till den lokala datorn i Workgroup-A arbetsgrupp.

Exempel 3: Lägga till en lokal dator i en domän

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

Det här kommandot lägger till den lokala datorn i domänen Domain01 med domänkontrollanten Domain01\DC01.

Kommandot använder parametrarna PassThru och Utförliga 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 -Force

Det 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 Restart för att starta om datorn när kopplingsåtgärden har slutförts och parametern Force för att förhindra användarbekräftelsemeddelanden.

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

Det 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 Restart 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 -Restart

Det 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  -Restart

Det här kommandot lägger till datorerna som visas i Servers.txt-filen i domänen Domain02. Den använder parametern Alternativ för att ange alternativet Win9xUpgrade. Parametern Restart startar om alla nyligen tillagda datorer när kopplingsåtgärden har slutförts.

Parametrar

-ComputerName

Anger vilka datorer som ska läggas till i en domän eller arbetsgrupp. Standardvärdet ä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 ComputerName för Add-Computer ä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. Standardvärdet ä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 Get-Credential cmdlet. 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:Current User Account Credentials
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 kräver Add-Computer att du bekräftar 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. Standardvärdet ä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 Get-Credential cmdlet. 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 åtgärden add-computer join. Ange ett eller flera värden i en kommaavgränsad sträng.

De godtagbara värdena för den här parametern är:

  • kontoSkapa: Skapar ett domänkonto. Cmdleten Add-Computer skapar 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.

  • PasswordPass: Anger datorns lösenord till värdet för parametern Credential(DomainCredential) när du har utfört en oskyddad koppling. Det här alternativet anger också att värdet för parametern Credential (DomainCredential) är ett datorlösenord, inte ett användarlösenord. Det här alternativet är endast giltigt när alternativet UnsecuredJoin har angetts.

-- 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-Computer fö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 för Win32_ComputerSystem-klassen i MSDN-biblioteket. Mer information om de här alternativen finns i NetJoinDomain-funktion i MSDN-biblioteket.

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:The default OU for machine objects for in the domain
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:False
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. Standardvärdet ä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 Get-Credential cmdlet. 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:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. 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

String

Du kan skicka namn och nya namn till Add-Computer-cmdleten.

Utdata

ComputerChangeInfo

När du använder parametern PassThru returnerar Add-Computer ett ComputerChangeInfo--objekt. Annars genererar den här cmdleten inga utdata.

Kommentarer

  • I Windows PowerShell 2.0 misslyckas parametern Server för Add-Computer även när servern finns. I Windows PowerShell 3.0 ändras implementeringen av parametern Server så att den fungerar tillförlitligt.