< Back

Set-AzureRmVMADDomainExtension

Tue Jan 29, 2019 9:39 pm

NAME Set-AzureRmVMADDomainExtension



SYNOPSIS

Adds an AD domain extension to a virtual machine.





SYNTAX

Set-AzureRmVMADDomainExtension [-ResourceGroupName] <String> [-VMName] <String> [-Credential <PSCredential>] [-DefaultProfile

<IAzureContextContainer>] [-DisableAutoUpgradeMinorVersion] -DomainName <String> [-ForceRerun <String>] [-JoinOption <UInt32>] [-Location

<String>] [-Name <String>] [-OUPath <String>] [-Restart] [-TypeHandlerVersion <String>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The Set-AzureRmVMADDomainExtension cmdlet adds an Azure Active Directory (AD) domain virtual machine extension to a virtual machine. This

extension lets your virtual machine join a domain.





PARAMETERS

-Credential <PSCredential>

Specifies the user name and password for the virtual machine as a PSCredential object. To obtain a credential, use the Get-Credential cmdlet.

For more information, type `Get-Help Get-Credential`.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DisableAutoUpgradeMinorVersion [<SwitchParameter>]

Indicates that this cmdlet disables auto-upgrade of the minor version of the extension.



Required? false

Position? named

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DomainName <String>

Specifies the name of the domain.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ForceRerun <String>

Indicates that this cmdlet forces a rerun of the same extension configuration on the virtual machine without uninstalling and reinstalling the

extension. The value can be any string different from the current value.



If forceUpdateTag is not changed, updates to public or protected settings are still applied by the handler.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-JoinOption <UInt32>

Specifies the join option.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Location <String>

Specifies the location of the virtual machine.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

Specifies the name of the domain extension to add.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-OUPath <String>

Specifies an organizational unit (OU) for the domain account. Enter the full distinguished name of the OU in quotation marks. The default

value is the default OU for machine objects in the domain.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ResourceGroupName <String>

Specifies the name of the resource group.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Restart [<SwitchParameter>]

Indicates that this cmdlet restarts the virtual machine. A restart is often required to make the change effective.



Required? false

Position? named

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-TypeHandlerVersion <String>

Specifies the version of the domain extension.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-VMName <String>

Specifies the name of the virtual machine.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs.



The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

Microsoft.Azure.Commands.Compute.Models.PSAzureOperationResponse







NOTES











RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... nextension

Get-AzureRmVMADDomainExtension