Set-AzureRmVMOperatingSystem
Establece las propiedades del sistema operativo de una máquina virtual.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Sintaxis
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Linux]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-DisablePasswordAuthentication]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
El cmdlet Set-AzureRmVMOperatingSystem establece las propiedades del sistema operativo para una máquina virtual. Puede especificar las credenciales de inicio de sesión, el nombre del equipo y el tipo de sistema operativo.
Ejemplos
Ejemplo 1: Establecimiento de las propiedades del sistema operativo para una nueva máquina virtual
PS C:\> $SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
PS C:\> $Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> $ComputerName = "ContosoVM122"
PS C:\> $WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
PS C:\> $TimeZone = "Pacific Standard Time"
PS C:\> $CustomData = "echo 'Hello World'"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $$VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone
El primer comando convierte una contraseña en una cadena segura y, a continuación, la almacena en la variable $SecurePassword.
Para obtener más información, escriba Get-Help ConvertTo-SecureString
.
El segundo comando crea una credencial para el usuario FullerP y la contraseña almacenada en $SecurePassword y, a continuación, almacena la credencial en la variable $Credential.
Para obtener más información, escriba Get-Help New-Object
.
El tercer comando obtiene el conjunto de disponibilidad denominado AvailablitySet03 en el grupo de recursos denominado ResourceGroup11 y, a continuación, almacena ese objeto en la variable $AvailabilitySet.
El cuarto comando crea un objeto de máquina virtual y, a continuación, lo almacena en la variable $VirtualMachine.
El comando asigna un nombre y un tamaño a la máquina virtual.
La máquina virtual pertenece al conjunto de disponibilidad almacenado en $AvailabilitySet.
Los cuatro comandos siguientes asignan valores a variables que se usarán en el siguiente comando.
Dado que podría especificar estas cadenas directamente en el comando Set-AzureRmVMOperatingSystem , este enfoque solo se usa para mejorar la legibilidad.
Sin embargo, puede usar un enfoque como este en scripts.
El comando final establece las propiedades del sistema operativo para la máquina virtual almacenada en $VirtualMachine.
El comando usa las credenciales almacenadas en $Credential.
El comando usa variables asignadas en comandos anteriores para algunos parámetros.
Parámetros
-ComputerName
Especifica el nombre del equipo.
Tipo: | String |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Credential
Especifica el nombre de usuario y la contraseña de la máquina virtual como un objeto PSCredential .
Para obtener una credencial, use el cmdlet Get-Credential.
Para obtener más información, escriba Get-Help Get-Credential
.
Tipo: | PSCredential |
Posición: | 3 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-CustomData
Especifica una cadena codificada en base 64 de datos personalizados. Esto se descodifica en una matriz binaria que se guarda como un archivo en la máquina virtual. La longitud máxima de la matriz binaria es de 65535 bytes.
Tipo: | String |
Posición: | 4 |
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: | AzureRmContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DisablePasswordAuthentication
Indica que este cmdlet deshabilita la autenticación con contraseña.
Tipo: | SwitchParameter |
Posición: | 5 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-DisableVMAgent
Deshabilite Aprovisionamiento del agente de máquina virtual.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EnableAutoUpdate
Indica que este cmdlet habilita la actualización automática.
Tipo: | SwitchParameter |
Posición: | 6 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Linux
Indica que el tipo de sistema operativo es Linux.
Tipo: | SwitchParameter |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-ProvisionVMAgent
Indica que la configuración requiere que el agente de máquina virtual esté instalado en la máquina virtual.
Tipo: | SwitchParameter |
Posición: | 5 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-TimeZone
Especifica la zona horaria de la máquina virtual.
Tipo: | String |
Posición: | 7 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-VM
Especifica el objeto de máquina virtual local en el que se van a establecer las propiedades del sistema operativo. Para obtener un objeto de máquina virtual, use el cmdlet Get-AzureRmVM. Cree un objeto de máquina virtual mediante el cmdlet New-AzureRmVMConfig.
Tipo: | PSVirtualMachine |
Alias: | VMProfile |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Windows
Indica que el tipo de sistema operativo es Windows.
Tipo: | SwitchParameter |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-WinRMCertificateUrl
Especifica el URI de un certificado WinRM. Esto debe almacenarse en un almacén de claves.
Tipo: | Uri |
Posición: | 10 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-WinRMHttp
Indica que este sistema operativo usa HTTP WinRM.
Tipo: | SwitchParameter |
Posición: | 8 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-WinRMHttps
Indica que este sistema operativo usa HTTPS WinRM.
Tipo: | SwitchParameter |
Posición: | 9 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |