Set-AzVMADDomainExtension

  • Referencia
Módulo:
Az.Compute

Agrega una extensión de dominio de AD a una máquina virtual.

Syntax

Set-AzVMADDomainExtension
   -DomainName <String>
   [-OUPath <String>]
   [-JoinOption <UInt32>]
   [-Credential <PSCredential>]
   [-Restart]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzVMADDomainExtension agrega una extensión de máquina virtual de Id. de Microsoft Entra a una máquina virtual. Esta extensión permite que la máquina virtual se una a un dominio.

Ejemplos

Ejemplo 1

# Create a Resource Group and Virtual Machine before this.
$extensionName = "extensionName"
$virtualMachineName = "vmName"
$resourceGroupName = "resourceGroupName"
$domainName = "domain.com"
Set-AzVMADDomainExtension -ResourceGroupName $resourceGroupName -VMName $virtualMachineName -Name $extensionName -DomainName $domainName

RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
                         True         OK OK

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica el nombre de usuario y la contraseña de la máquina virtual como un objeto PSCredential . Para obtener una credencial, use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgradeMinorVersion

Indica que este cmdlet deshabilita la actualización automática de la versión secundaria de la extensión.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DomainName

Especifica el nombre del dominio.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ForceRerun

Indica que este cmdlet fuerza una nueva ejecución de la misma configuración de extensión en la máquina virtual sin desinstalar y reinstalar la extensión. El valor puede ser cualquier cadena diferente del valor actual. Si forceUpdateTag no se cambia, el controlador sigue aplicando las actualizaciones a la configuración pública o protegida.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-JoinOption

Especifica la opción de combinación. Para obtener opciones de combinación, consulte JoinOptions.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Especifica la ubicación de la máquina virtual.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica el nombre de la extensión de dominio que se va a agregar.

Type:String
Aliases:ExtensionName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

Inicia la operación y vuelve inmediatamente antes de que se complete la operación. Para determinar si la operación se ha completado correctamente, use algún otro mecanismo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OUPath

Especifica una unidad organizativa (OU) para la cuenta de dominio. Escriba entre comillas el nombre distintivo de la unidad organizativa. El valor predeterminado es la unidad organizativa predeterminada para los objetos de equipo del dominio.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Restart

Indica que este cmdlet reinicia la máquina virtual. A menudo es necesario reiniciar para que el cambio surta efecto.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Especifica la versión de la extensión de dominio.

Type:String
Aliases:HandlerVersion, Version
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Especifica el nombre de la máquina virtual.

Type:String
Aliases:ResourceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Nullable<T>[[System.UInt32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

PSCredential

SwitchParameter

Salidas

PSAzureOperationResponse