Set-AzVMAccessExtension
Agrega la extensión VMAccess a una máquina virtual.
Sintaxis
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.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableAutoUpgradeMinorVersion
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Location
Especifica la ubicación de la máquina virtual.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Name
Especifica el nombre de la extensión que agrega este cmdlet.
| Tipo: | String |
| Alias: | ExtensionName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos de la máquina virtual.
| Tipo: | String |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Alias: | HandlerVersion, Version |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-VMName
Especifica el nombre de una máquina virtual. Este cmdlet agrega VMAccess para la máquina virtual que especifica este parámetro.
| Tipo: | String |
| Alias: | ResourceName |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
