Set-AzureRmVMOperatingSystem
Définit les propriétés de système d’exploitation d’une machine virtuelle.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module 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
L’applet de commande Set-AzureRmVMOperatingSystem définit les propriétés du système d’exploitation pour une machine virtuelle. Vous pouvez spécifier les informations d’identification d’ouverture de session, le nom de l’ordinateur et le type de système d’exploitation.
Exemples
Exemple 1 : Définir les propriétés du système d’exploitation pour les nouvelles machines virtuelles
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 $TimeZoneLa première commande convertit un mot de passe en chaîne sécurisée, puis la stocke dans la variable $SecurePassword.
Pour plus d'informations, voir Get-Help ConvertTo-SecureString.
La deuxième commande crée des informations d’identification pour l’utilisateur FullerP et le mot de passe stockés dans $SecurePassword, puis stocke les informations d’identification dans la variable $Credential.
Pour plus d'informations, voir Get-Help New-Object.
La troisième commande obtient le groupe à haute disponibilité nommé AvailablitySet03 dans le groupe de ressources nommé ResourceGroup11, puis stocke cet objet dans la variable $AvailabilitySet.
La quatrième commande crée un objet de machine virtuelle, puis la stocke dans la variable $VirtualMachine.
La commande attribue un nom et une taille à la machine virtuelle.
La machine virtuelle appartient au groupe à haute disponibilité stocké dans $AvailabilitySet.
Les quatre commandes suivantes attribuent des valeurs aux variables à utiliser dans la commande suivante.
Étant donné que vous pouvez spécifier ces chaînes directement dans la commande Set-AzureRmVMOperatingSystem , cette approche est utilisée uniquement pour la lisibilité.
Toutefois, vous pouvez utiliser une approche telle que celle-ci dans les scripts.
La commande finale définit les propriétés du système d’exploitation de la machine virtuelle stockée dans $VirtualMachine.
La commande utilise les informations d’identification stockées dans $Credential.
La commande utilise des variables affectées dans les commandes précédentes pour certains paramètres.
Paramètres
-ComputerName
Spécifie le nom de l'ordinateur.
| Type: | String |
| Position: | 2 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
Spécifie le nom d’utilisateur et le mot de passe de la machine virtuelle en tant qu’objet PSCredential .
Pour obtenir des informations d’identification, utilisez l’applet de commande Get-Credential.
Pour plus d'informations, voir Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | 3 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CustomData
Spécifie une chaîne codée en base 64 de données personnalisées. Il s’agit d’un tableau binaire enregistré sous forme de fichier sur la machine virtuelle. La longueur maximale du tableau binaire est de 65535 octets.
| Type: | String |
| Position: | 4 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisablePasswordAuthentication
Indique que cette applet de commande désactive l’authentification par mot de passe.
| Type: | SwitchParameter |
| Position: | 5 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisableVMAgent
Désactivez l’agent de machine virtuelle de provisionnement.
| Type: | SwitchParameter |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAutoUpdate
Indique que cette applet de commande active la mise à jour automatique.
| Type: | SwitchParameter |
| Position: | 6 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Linux
Indique que le type de système d’exploitation est Linux.
| Type: | SwitchParameter |
| Position: | 1 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProvisionVMAgent
Indique que les paramètres nécessitent l’installation de l’agent de machine virtuelle sur la machine virtuelle.
| Type: | SwitchParameter |
| Position: | 5 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeZone
Spécifie le fuseau horaire de la machine virtuelle.
| Type: | String |
| Position: | 7 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
Spécifie l’objet de machine virtuelle locale sur lequel définir les propriétés du système d’exploitation. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-AzureRmVM. Créez un objet de machine virtuelle à l’aide de l’applet de commande New-AzureRmVMConfig.
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Windows
Indique que le type de système d’exploitation est Windows.
| Type: | SwitchParameter |
| Position: | 1 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WinRMCertificateUrl
Spécifie l’URI d’un certificat WinRM. Cela doit être stocké dans un coffre de clés.
| Type: | Uri |
| Position: | 10 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WinRMHttp
Indique que ce système d’exploitation utilise HTTP WinRM.
| Type: | SwitchParameter |
| Position: | 8 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WinRMHttps
Indique que ce système d’exploitation utilise HTTPS WinRM.
| Type: | SwitchParameter |
| Position: | 9 |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |