Set-AzVMAccessExtension
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.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | False |
Requerido: | 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
.
Tipo: | PSCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableAutoUpgradeMinorVersion
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Especifica la ubicación de la máquina virtual.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica el nombre de la extensión que agrega este cmdlet.
Tipo: | String |
Aliases: | ExtensionName |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos de la máquina virtual.
Tipo: | String |
Position: | 0 |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Aliases: | HandlerVersion, Version |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Aliases: | ResourceName |
Position: | 1 |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | False |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de