Partager via

Add-AzureRmVMAdditionalUnattendContent

  • Référence
Module:
AzureRM.Compute

Ajoute des informations au fichier de réponse d’installation de Windows sans assistance.

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

Add-AzureRmVMAdditionalUnattendContent
   [-VM] <PSVirtualMachine>
   [[-Content] <String>]
   [[-SettingName] <SettingNames>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzureRmVMAdditionalUnattendContent ajoute des informations au fichier de réponse du programme d’installation de Windows sans assistance. Spécifiez des informations encodées en base 64 supplémentaires .xml mises en forme que cette applet de commande ajoute au fichier unattend.xml.

Exemples

Exemple 1 : Ajouter du contenu à unattend.xml

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
PS C:\> $Credential = Get-Credential
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine  -Windows -ComputerName "Contoso26" -Credential $Credential
PS C:\> $AucContent = "<UserAccounts><AdministratorPassword><Value>" + "Password" + "</Value><PlainText>true</PlainText></AdministratorPassword></UserAccounts>";
PS C:\> $VirtualMachine = Add-AzureRmVMAdditionalUnattendContent -VM $VirtualMachine -Content $AucContent -SettingName "AutoLogon"

La première commande obtient le groupe à haute disponibilité nommé AvailablitySet03 dans le groupe de ressources nommé ResourceGroup11, puis stocke cet objet dans la variable $AvailabilitySet. La deuxiè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. La troisième commande crée un objet d’informations d’identification à l’aide de l’applet de commande Get-Credential, puis stocke le résultat dans la variable $Credential. La commande vous invite à entrer un nom d’utilisateur et un mot de passe. Pour plus d'informations, voir Get-Help Get-Credential. La quatrième commande utilise l’applet de commande Set-AzureRmVMOperatingSystem pour configurer la machine virtuelle stockée dans $VirtualMachine. La cinquième commande affecte du contenu à la variable $AucContent. Le contenu inclut un mot de passe. La commande finale ajoute le contenu stocké dans $AucContent au fichier unattend.xml.

Paramètres

-Content

Spécifie le contenu au format XML encodé en base 64. Cette applet de commande ajoute le contenu au fichier unattend.xml. Le contenu XML doit être inférieur à 4 Ko et doit inclure l’élément racine du paramètre ou de la fonctionnalité que cette applet de commande insère.

Type:String
Position:1
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

-SettingName

Spécifie le nom du paramètre auquel le contenu s’applique. Les valeurs valides pour ce paramètre sont :

  • FirstLogonCommands
  • AutoLogon
Type:Nullable<T>[SettingNames]
Valeurs acceptées:AutoLogon, FirstLogonCommands
Position:2
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 que cette applet de commande modifie. 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

Entrées

PSVirtualMachine

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.SettingNames, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Sorties

PSVirtualMachine