Freigeben über

Add-AzureRmVMAdditionalUnattendContent

  • Referenz
Modul:
AzureRM.Compute

Fügt der Antwortdatei für unbeaufsichtigte Windows Setup Informationen hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Add-AzureRmVMAdditionalUnattendContent-Cmdlet fügt informationen zur unbeaufsichtigten Antwortdatei für Windows Setup hinzu. Geben Sie zusätzliche base64-codierte .xml formatierten Informationen an, die dieses Cmdlet der unattend.xml-Datei hinzufügt.

Beispiele

Beispiel 1: Hinzufügen von Inhalt zu 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"

Der erste Befehl ruft den Verfügbarkeitssatz "AvailablitySet03" in der Ressourcengruppe "ResourceGroup11" ab und speichert dieses Objekt dann in der $AvailabilitySet Variablen. Der zweite Befehl erstellt ein Objekt eines virtuellen Computers und speichert es dann in der $VirtualMachine Variablen. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Der virtuelle Computer gehört zu dem in $AvailabilitySet gespeicherten Verfügbarkeitssatz. Der dritte Befehl erstellt ein Anmeldeinformationsobjekt mithilfe des Cmdlets "Get-Credential" und speichert dann das Ergebnis in der variablen $Credential. Die Eingabeaufforderungen geben Einen Benutzernamen und ein Kennwort ein. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential. Der vierte Befehl verwendet das Cmdlet Set-AzureRmVMOperatingSystem , um den virtuellen Computer zu konfigurieren, der in $VirtualMachine gespeichert ist. Der fünfte Befehl weist der variablen $AucContent Inhalte zu. Der Inhalt enthält ein Kennwort. Mit dem letzten Befehl wird der unattend.xml Datei der in $AucContent gespeicherte Inhalt hinzugefügt.

Parameter

-Content

Gibt base64-codierte XML-formatierten Inhalt an. Mit diesem Cmdlet wird der unattend.xml Datei der Inhalt hinzugefügt. Der XML-Inhalt muss kleiner als 4 KB sein und das Stammelement für die Einstellung oder das Feature enthalten, das dieses Cmdlet einfügt.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SettingName

Gibt den Namen der Einstellung an, auf die der Inhalt angewendet wird. Zulässige Werte für diesen Parameter:

  • FirstLogonCommands
  • Automatische Anmeldung
Typ:Nullable<T>[SettingNames]
Zulässige Werte:AutoLogon, FirstLogonCommands
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VM

Gibt das Objekt des virtuellen Computers an, das dieses Cmdlet ändert. Verwenden Sie das Cmdlet Get-AzureRmVM, um ein Objekt eines virtuellen Computers abzurufen. Erstellen Sie ein Objekt eines virtuellen Computers mithilfe des Cmdlets New-AzureRmVMConfig .

Typ:PSVirtualMachine
Aliase:VMProfile
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PSVirtualMachine

String

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

Ausgaben

PSVirtualMachine