Compartir a través de

Set-AzureRmVMOperatingSystem

  • Referencia
Módulo:
AzureRM.Compute

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.

Syntax

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
Position:2
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters: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
Position:3
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters: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
Position:4
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:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DisablePasswordAuthentication

Indica que este cmdlet deshabilita la autenticación con contraseña.

Tipo:SwitchParameter
Position:5
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableVMAgent

Deshabilite Aprovisionamiento del agente de máquina virtual.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAutoUpdate

Indica que este cmdlet habilita la actualización automática.

Tipo:SwitchParameter
Position:6
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

Indica que el tipo de sistema operativo es Linux.

Tipo:SwitchParameter
Position:1
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ProvisionVMAgent

Indica que la configuración requiere que el agente de máquina virtual esté instalado en la máquina virtual.

Tipo:SwitchParameter
Position:5
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeZone

Especifica la zona horaria de la máquina virtual.

Tipo:String
Position:7
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:VMProfile
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Windows

Indica que el tipo de sistema operativo es Windows.

Tipo:SwitchParameter
Position:1
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-WinRMCertificateUrl

Especifica el URI de un certificado WinRM. Esto debe almacenarse en un almacén de claves.

Tipo:Uri
Position:10
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-WinRMHttp

Indica que este sistema operativo usa HTTP WinRM.

Tipo:SwitchParameter
Position:8
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-WinRMHttps

Indica que este sistema operativo usa HTTPS WinRM.

Tipo:SwitchParameter
Position:9
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Salidas

PSVirtualMachine