-
Notifications
You must be signed in to change notification settings - Fork 141
ADComputer
Parameter | Attribute | DataType | Description | Allowed Values |
---|---|---|---|---|
ComputerName | Key | String | Specifies the name of the Active Directory computer account to manage. You can identify a computer by its distinguished name, GUID, security identifier (SID) or Security Accounts Manager (SAM) account name. | |
Location | Write | String | Specifies the location of the computer, such as an office number. | |
DnsHostName | Write | String | Specifies the fully qualified domain name (FQDN) of the computer account. | |
ServicePrincipalNames | Write | String[] | Specifies the service principal names for the computer account. | |
UserPrincipalName | Write | String | Specifies the User Principal Name (UPN) assigned to the computer account. | |
DisplayName | Write | String | Specifies the display name of the computer account. | |
Path | Write | String | Specifies the X.500 path of the Organizational Unit (OU) or container where the computer is located. | |
Description | Write | String | Specifies a description of the computer account. | |
Manager | Write | String | Specifies the user or group Distinguished Name that manages the computer account. Valid values are the user's or group's DistinguishedName, ObjectGUID, SID or SamAccountName. | |
DomainController | Write | String | Specifies the Active Directory Domain Services instance to connect to perform the task. | |
Credential | Write | PSCredential | Specifies the user account credentials to use to perform the task. | |
RequestFile | Write | String | Specifies the full path to the Offline Domain Join Request file to create. | |
Ensure | Write | String | Specifies whether the computer account is present or absent. Default value is 'Present'. | Present, Absent |
RestoreFromRecycleBin | Write | Boolean | Try to restore the computer account from the recycle bin before creating a new one. | |
EnabledOnCreation | Write | Boolean | Specifies if the computer account is created enabled or disabled. By default the Enabled property of the computer account will be set to the default value of the cmdlet New-ADComputer. This property is ignored if the parameter RequestFile is specified in the same configuration. This parameter does not enforce the property Enabled. To enforce the property Enabled see the resource ADObjectEnabledState. | |
DistinguishedName | Read | String | Returns the X.500 path of the computer object. | |
SID | Read | String | Returns the security identifier of the computer object. | |
SamAccountName | Read | String | Returns the security identifier of the computer object. | |
Enabled | Read | Boolean | Returns $true if the computer object is enabled, otherwise it returns $false. |
The ADComputer DSC resource will manage computer accounts within Active Directory. This resource can be used to provision a computer account before the computer is added to the domain. These pre-created computer objects can be used with offline domain join, unsecure domain Join and RODC domain join scenarios.
Note: An Offline Domain Join (ODJ) request file will only be created when a computer account is first created in the domain. Setting an Offline Domain Join (ODJ) Request file path for a configuration that updates a computer account that already exists, or restore it from the recycle bin will not cause the Offline Domain Join (ODJ) request file to be created.
- Target machine must be running Windows Server 2008 R2 or later.
This configuration will create two Active Directory computer accounts enabled. The property Enabled will not be enforced in either case.
Configuration ADComputer_AddComputerAccount_Config
{
param
(
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[System.Management.Automation.PSCredential]
$Credential
)
Import-DscResource -ModuleName ActiveDirectoryDsc
node localhost
{
ADComputer 'CreateEnabled_SQL01'
{
ComputerName = 'SQL01'
PsDscRunAsCredential = $Credential
}
ADComputer 'CreateEnabled_SQL02'
{
ComputerName = 'SQL02'
EnabledOnCreation = $true
PsDscRunAsCredential = $Credential
}
}
}
This configuration will create an Active Directory computer account disabled. The property Enabled will not be enforced.
Configuration ADComputer_AddComputerAccountDisabled_Config
{
param
(
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[System.Management.Automation.PSCredential]
$Credential
)
Import-DscResource -ModuleName ActiveDirectoryDsc
node localhost
{
ADComputer 'CreateDisabled'
{
ComputerName = 'CLU_CNO01'
EnabledOnCreation = $false
PsDscRunAsCredential = $Credential
}
}
}
This configuration will create an Active Directory computer account on the specified domain controller and in the specific organizational unit.
Configuration ADComputer_AddComputerAccountSpecificPath_Config
{
param
(
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[System.Management.Automation.PSCredential]
$Credential
)
Import-DscResource -ModuleName ActiveDirectoryDsc
node localhost
{
ADComputer 'CreateComputerAccount'
{
DomainController = 'DC01'
ComputerName = 'SQL01'
Path = 'OU=Servers,DC=contoso,DC=com'
Credential = $Credential
}
}
}
This configuration will create an Active Directory computer account on the specified domain controller and in the specific organizational unit. After the account is create an Offline Domain Join Request file is created to the specified path.
Configuration ADComputer_AddComputerAccountAndCreateODJRequest_Config
{
param
(
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[System.Management.Automation.PSCredential]
$Credential
)
Import-DscResource -ModuleName ActiveDirectoryDsc
node localhost
{
ADComputer 'CreateComputerAccount'
{
DomainController = 'DC01'
ComputerName = 'NANO-200'
Path = 'OU=Servers,DC=contoso,DC=com'
RequestFile = 'D:\ODJFiles\NANO-200.txt'
Credential = $Credential
}
}
}
This configuration will create a computer account disabled, configure a cluster using the disabled computer account, and enforcing the computer account to be enabled.
Configuration ADComputer_CreateClusterComputerAccount_Config
{
param
(
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[System.Management.Automation.PSCredential]
$Credential
)
Import-DscResource -ModuleName ActiveDirectoryDsc
Import-DscResource -ModuleName xFailoverCluster
node localhost
{
ADComputer 'ClusterAccount'
{
ComputerName = 'CLU_CNO01'
EnabledOnCreation = $false
}
xCluster 'CreateCluster'
{
Name = 'CLU_CNO01'
StaticIPAddress = '192.168.100.20/24'
DomainAdministratorCredential = $Credential
DependsOn = '[ADComputer]ClusterAccount'
}
ADObjectEnabledState 'EnforceEnabledPropertyToEnabled'
{
Identity = 'CLU_CNO01'
ObjectClass = 'Computer'
Enabled = $true
DependsOn = '[xCluster]CreateCluster'
}
}
}
- ADComputer
- ADDomain
- ADDomainController
- ADDomainControllerProperties
- ADDomainDefaultPasswordPolicy
- ADDomainFunctionalLevel
- ADDomainTrust
- ADFineGrainedPasswordPolicy
- ADForestFunctionalLevel
- ADForestProperties
- ADGroup
- ADKDSKey
- ADManagedServiceAccount
- ADObjectEnabledState
- ADObjectPermissionEntry
- ADOptionalFeature
- ADOrganizationalUnit
- ADReadOnlyDomainControllerAccount
- ADReplicationSite
- ADReplicationSiteLink
- ADReplicationSubnet
- ADServicePrincipalName
- ADUser
- Home
- WaitForADDomain