Add-Computer

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 -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 arbetsgruppen Workgroup-A.

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 hjälp av 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

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

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

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

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

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

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

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

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

$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

Den 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.

Exempel 10: Lägg till en dator i en domän med ett nytt namn

Med den här kombinationen av kommandon undviker du flera omstarter och flera skrivningar till Active Directory-skrivningar för samma objekt när datorn ansluter domänen med det nya namnet.

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

Parametrar

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Indata

String

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

Utdata

ComputerChangeInfo

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-Computer för även när servern finns. I Windows PowerShell 3.0 ändras implementeringen av serverparametern så att den fungerar tillförlitligt.

Relaterade länkar

• Checkpoint-Computer
• Remove-Computer
• Restart-Computer
• Rename-Computer
• Restore-Computer
• Stop-Computer
• Test-Connection