Add-Computer

Syntax

Domain (Standard)

Add-Computer
    [-DomainName] <String>
    -Credential <PSCredential>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-UnjoinDomainCredential <PSCredential>]
    [-OUPath <String>]
    [-Server <String>]
    [-Unsecure]
    [-Options <JoinOptions>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Workgroup

Add-Computer
    [-WorkgroupName] <String>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exempel

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

Add-Computer -DomainName Domain01 -Restart

Exempel 2: Lägga till en lokal dator i en arbetsgrupp

Add-Computer -WorkgroupName WORKGROUP-A

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

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

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"

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

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

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

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

Exempel 9: Lägga till en dator i en domän med fördefinierade datorautentiseringsuppgifter

$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

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

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

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.

Parameteregenskaper

Parameteruppsättningar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Options

Anger avancerade alternativ för kopplingsåtgärden Add-Computer . 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. Om du vill skicka ett datorlösenord måste du använda det här alternativet i kombination med PasswordPass 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. 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-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 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.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Server

Anger namnet på en domänkontrollant som lägger till datorn i domänen. Ange namnet i FQDN-format. Som standard anges ingen domänkontrollant.

Från och med augusti 2024 kräver säkerhetshärdning för domänanslutning att du använder FQDN för domänkontrollanten. Till exempel: DC1.contoso.com. Mer information finns i NetJoin Domain Join Hardning Changes (NetJoin Domain Join Hardning Changes).

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Unsecure

Utför en osäker koppling till den angivna domänen.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Parameteruppsättningar

-WorkgroupName

Anger namnet på en arbetsgrupp som datorerna läggs till i. Standardvärdet är "WORKGROUP".

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

String

Utdata

ComputerChangeInfo

Kommentarer

Relaterade länkar

• Checkpoint-Computer
• Ta bort dator
• Starta om datorn
• Byt namn på dator
• Återställ dator
• Stäng av datorn
• Testa anslutning