Add-Computer - PowerShell command help and examples

Add the local computer to a domain or workgroup. (Add-Computer)


NAME
Add-Computer
SYNOPSIS
Add the local computer to a domain or workgroup.
SYNTAX
Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Add-Computer cmdlet adds the local computer to a domain or workgroup, or moves it from one domain to another. It also creates a domain account if the computer is added to the domain without an account. You can use the parameters of this cmdlet to specify an organizational unit (OU) and domain controller or to perform an unsecure join. To get the results of the command, use the Verbose and PassThru parameters.
PARAMETERS
-Credential <PSCredential> Specifies a user account that has permission to perform this action. The default is the current user. Type a user name, such as "User01" or "Domain01\User01", or enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, you will be prompted for a password. Required? false Position? named Default value Current User Account Credentials Accept pipeline input? false Accept wildcard characters? false -DomainName <string> Specifies a domain for the computer account. This parameter is required. Required? true Position? 2 Default value Accept pipeline input? false Accept wildcard characters? false -OUPath <string> Specifies an organizational unit (OU) for the domain account. Enter the full distinguished name of the OU. The default value is the default OU for machine objects in the domain. Required? false Position? named Default value The default OU for machine objects for in the domain Accept pipeline input? false Accept wildcard characters? false -PassThru [<SwitchParameter>] Returns the results of the command. By default, this cmdlet does not generate any output. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false -Server <string> Specifies the name of a domain controller that adds the computer to the domain. Enter the name in DomainName\ComputerName format. The default is the local computer. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false -Unsecure [<SwitchParameter>] Performs an unsecure join. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false -WorkGroupName <string> Specifies the name of a work group for the computer. If you omit this parameter, the computer is joined to a domain. Required? true Position? 3 Default value Accept pipeline input? false Accept wildcard characters? false -Confirm [<SwitchParameter>] Prompts you for confirmation before executing the command. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false -WhatIf [<SwitchParameter>] Describes what would happen if you executed the command without actually executing the command. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false <CommonParameters> This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters".
INPUTS
None You cannot pipe objects to Add-Computer.
OUTPUTS
Microsoft.PowerShell.Commands.ComputerChangeInfo When you use the PassThru parameter, Add-Computer returns a ComputerChangeInfo object. Otherwise, this cmdlet does not generate any output.
NOTES

Examples

EXAMPLE 1
C:\PS>add-computer -domainname Domain01; restart-computer
Description
----------- These commands add the local computer to the Domain01 domain using the credentials of the current user. The first command adds the computer to the domain. The second command uses the Restart-Computer cmdlet to restart the computer, which completes the join operation. The semi-colon (;) separates the two commands.
EXAMPLE 2
C:\PS>add-computer -workgroupname WORKGROUP-A
Description
----------- This command adds the local computer to the Workgroup-A workgroup.
EXAMPLE 3
C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose
Description
----------- This command adds the local computer to the Domain01 domain by using the Domain01\DC01 domain controller. The command uses the PassThru and Verbose parameters to get detailed information about the results of the command.
EXAMPLE 4
C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com
Description
----------- This command adds the Server01 and Server02 computers to the Domain02 domain. It uses the OUPath command to specify the organization unit for the new accounts.
EXAMPLE 5
C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru
Description
----------- This command adds the local computer to the Domain02 domain by using the credentials of a domain administrator. The command uses the PassThru parameter to generate a brief report about the results of the command. RELATED LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=135194 Checkpoint-Computer Remove-Computer Restart-Computer Restore-Computer Stop-Computer Test-Connection C:\Windows>powershell get-help Remove-Computer -full

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016











Windows-10


... Windows 10 FAQ
... Windows 10 How To


Windows 10 How To


... Windows 11 How To
... Windows 10 FAQ



PowerShell: Add the local computer to a domain or workgroup.

HTTP: ... PS_Windows/en/Add-Computer.htm
0.078
13669
For Crashes in Windows 10 and 11, using System File Checker! Portable use of Don't Sleep on Windows 10 / 11 and protected directory problem! Do I need HDMI 2.1 or not? WIA Scannerprofil umstellen Auswahl Farbformat, Farbe, Graustufen, Schwarz Weiß! My-Documents Windows 10 / 11, change the path, how to? Touchscreen Test auf defekte Berührungspunkte, wozu? Größe der Bildschirmlupe nach meinen Wünschen ändern? Disable auto sleep mode on Windows 10 / 11 tablet PC, how to? The screen magnifier in Windows 10/11, where is it? Fragen zu Alternative Kältemittel Auto-Klimaanlagen?



(0)