Share via

Set-AzureVMAccessExtension

  • Referencia
Módulo:
Azure

Establece la extensión VMAccess para una máquina virtual.

Nota

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de Azure Resource Manager.

Syntax

Set-AzureVMAccessExtension
   [[-UserName] <String>]
   [[-Password] <String>]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMAccessExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMAccessExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureVMAccessExtension agrega la extensión VMAccess de máquina virtual 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.

Ejemplos

Ejemplo 1: Establecimiento de la extensión VMAccess aplicada a una máquina virtual especificada

PS C:\> Set-AzureVMAccessExtension -VM $VM -UserName $User -Password $PWD;

Este comando establece la extensión VMAccess aplicada a la máquina virtual especificada como almacenada en la variable $VM.

Parámetros

-Disable

Indica que este cmdlet establece el estado de extensión en Deshabilitar.

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

-ForceUpdate

Indica que este cmdlet vuelve a aplicar una configuración a una extensión cuando no se ha actualizado la configuración.

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

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica una variable de información.

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

-Password

Especifica la contraseña para restablecer la credencial de la máquina virtual.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-ReferenceName

Especifica el nombre de referencia de la extensión de acceso.

Se trata de una cadena definida por el usuario que se usa para hacer referencia a una extensión. Se especifica cuando la extensión se agrega a la máquina virtual por primera vez. Para las actualizaciones posteriores, debe especificar el nombre de referencia usado anteriormente al actualizar la extensión. ReferenceName asignado a una extensión se devuelve mediante el cmdlet Get-AzureVM.

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

-Uninstall

Indica si este cmdlet desinstala la extensión de acceso.

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

-UserName

Especifica el nombre de usuario que usa este cmdlet para restablecer la credencial de la máquina virtual.

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

-Version

Especifica la versión de la extensión.

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

-VM

Especifica el objeto de máquina virtual persistente.

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