Compartir a través de

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 las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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.

Tipo:SwitchParameter
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ForceUpdate

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

Tipo:SwitchParameter
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Password

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

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

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

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Uninstall

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

Tipo:SwitchParameter
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UserName

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

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Version

Especifica la versión de la extensión.

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VM

Especifica el objeto de máquina virtual persistente.

Tipo:IPersistentVM
Alias:InputObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False