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éprécié 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.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
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 $TimeZone
La 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 |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DisableVMAgent
Désactivez l’agent de machine virtuelle de provisionnement.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EnableAutoUpdate
Indique que cette applet de commande active la mise à jour automatique.
Type: | SwitchParameter |
Position: | 6 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Linux
Indique que le type de système d’exploitation est Linux.
Type: | SwitchParameter |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-TimeZone
Spécifie le fuseau horaire de la machine virtuelle.
Type: | String |
Position: | 7 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Alias: | VMProfile |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Windows
Indique que le type de système d’exploitation est Windows.
Type: | SwitchParameter |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WinRMHttp
Indique que ce système d’exploitation utilise HTTP WinRM.
Type: | SwitchParameter |
Position: | 8 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WinRMHttps
Indique que ce système d’exploitation utilise HTTPS WinRM.
Type: | SwitchParameter |
Position: | 9 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |