Set-AzVMAccessExtension

  • Referencia
Módulo:
Az.Compute

Agrega la extensión VMAccess a una máquina virtual.

Syntax

Set-AzVMAccessExtension
   [-Credential <PSCredential>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzVMAccessExtension agrega la extensión VMAccess de máquina virtual de acceso a máquinas virtuales (VMAccess) a una máquina virtual. La extensión VMAccess se puede usar para establecer una contraseña temporal y se debe cambiar inmediatamente después de iniciar sesión en la máquina. Esto no se admite en controladores de dominio de Windows.

Ejemplos

Ejemplo 1: Agregar una extensión VMAccess

Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"

Este comando agrega una extensión VMAccess para la máquina virtual denominada VirtualMachine07 en ResourceGroup11. El comando especifica el nombre y la versión del controlador de tipos para VMAccess.

Ejemplo 2

Agrega la extensión VMAccess a una máquina virtual. (generado automáticamente)

Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'

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 . Si escribe un nombre distinto al de la cuenta de administrador local actual en la máquina virtual, la extensión VMAccess agregará una cuenta de administrador local con ese nombre y asignará la contraseña especificada a esa cuenta. Si la cuenta de administrador local en la máquina virtual existe, restablecerá la contraseña y, si la cuenta está deshabilitada, la extensión VMAccess la habilitará. 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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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

-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 que agrega este cmdlet.

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

-ResourceGroupName

Especifica el nombre del grupo de recursos de la máquina virtual.

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

-TypeHandlerVersion

Especifica la versión de la extensión que se va a usar para esta máquina virtual. Para obtener la versión, ejecute el cmdlet Get-AzVMExtensionImage con un valor de Microsoft.Compute para el parámetro PublisherName y VMAccessAgent para el parámetro Type . El valor de typeHandlerVersion debe ser 2.0 o superior, porque la versión 1 está en desuso.

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 una máquina virtual. Este cmdlet agrega VMAccess para la máquina virtual que especifica este parámetro.

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

PSCredential

String

SwitchParameter

Salidas

PSAzureOperationResponse