Set-AzVMOperatingSystem
Legt die Eigenschaften des Betriebssystems während der Erstellung eines neuen virtuellen Computers fest oder aktualisiert einen virtuellen Computer.
Syntax
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Linux]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-PatchMode <String>]
[-DisablePasswordAuthentication]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-AzVMOperatingSystem legt die Betriebssystemeigenschaften während der Erstellung eines neuen virtuellen Computers fest. Sie können Anmeldeinformationen, Computername und Betriebssystemtyp angeben.
Beispiele
Beispiel 1: Festlegen von Betriebssystemeigenschaften für einen neuen virtuellen Computer
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform"
Der erste Befehl konvertiert ein Kennwort in eine sichere Zeichenfolge und speichert es dann in der variablen $SecurePassword.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help ConvertTo-SecureString
.
Der zweite Befehl erstellt eine Anmeldeinformation für den Benutzer FullerP und das kennwort, das in $SecurePassword gespeichert ist, und speichert dann die Anmeldeinformationen in der variablen $Credential.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help New-Object
.
Der dritte Befehl ruft den Verfügbarkeitssatz "AvailabilitySet03" in der Ressourcengruppe "ResourceGroup11" ab und speichert dieses Objekt dann in der $AvailabilitySet Variablen.
Der vierte 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.
Die nächsten vier Befehle weisen Variablen Werte zu, die im folgenden Befehl verwendet werden sollen.
Da Sie diese Zeichenfolgen direkt im Befehl "Set-AzVMOperatingSystem " angeben können, wird dieser Ansatz nur zur Lesbarkeit verwendet.
Sie können jedoch einen Ansatz wie diese in Skripts verwenden.
Der letzte Befehl legt betriebssystemeigenschaften für den virtuellen Computer fest, der in $VirtualMachine gespeichert ist.
Der Befehl verwendet die in $Credential gespeicherten Anmeldeinformationen.
Der Befehl verwendet Variablen, die in früheren Befehlen für einige Parameter zugewiesen wurden.
Beispiel 2: Festlegen von Betriebssystemeigenschaften für einen neuen virtuellen Computer mit aktiviertem Hot Patching
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform" -EnableHotPatching
Der erste Befehl konvertiert ein Kennwort in eine sichere Zeichenfolge und speichert es dann in der variablen $SecurePassword.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help ConvertTo-SecureString
.
Der zweite Befehl erstellt eine Anmeldeinformation für den Benutzer FullerP und das kennwort, das in $SecurePassword gespeichert ist, und speichert dann die Anmeldeinformationen in der variablen $Credential.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help New-Object
.
Der dritte Befehl ruft den Verfügbarkeitssatz "AvailabilitySet03" in der Ressourcengruppe "ResourceGroup11" ab und speichert dieses Objekt dann in der $AvailabilitySet Variablen.
Der vierte 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.
Die nächsten vier Befehle weisen Variablen Werte zu, die im folgenden Befehl verwendet werden sollen.
Da Sie diese Zeichenfolgen direkt im Befehl "Set-AzVMOperatingSystem " angeben können, wird dieser Ansatz nur zur Lesbarkeit verwendet.
Sie können jedoch einen Ansatz wie diese in Skripts verwenden.
Der letzte Befehl legt betriebssystemeigenschaften für den virtuellen Computer fest, der in $VirtualMachine gespeichert ist.
Der Befehl verwendet die in $Credential gespeicherten Anmeldeinformationen.
Der Befehl verwendet Variablen, die in früheren Befehlen für einige Parameter zugewiesen wurden.
Der Befehl aktiviert Hotpatching auf dem virtuellen Computer.
Beispiel 3: Festlegen von Betriebssystemeigenschaften für einen neuen virtuellen Linux-Computer
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -PatchMode "AutomaticByPlatform"
Der erste Befehl konvertiert ein Kennwort in eine sichere Zeichenfolge und speichert es dann in der variablen $SecurePassword.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help ConvertTo-SecureString
.
Der zweite Befehl erstellt eine Anmeldeinformation für den Benutzer FullerP und das kennwort, das in $SecurePassword gespeichert ist, und speichert dann die Anmeldeinformationen in der variablen $Credential.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help New-Object
.
Der dritte Befehl ruft den Verfügbarkeitssatz "AvailabilitySet03" in der Ressourcengruppe "ResourceGroup11" ab und speichert dieses Objekt dann in der $AvailabilitySet Variablen.
Der vierte 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.
Die nächsten beiden Befehle weisen Variablen Werte zu, die im folgenden Befehl verwendet werden sollen.
Der letzte Befehl legt betriebssystemeigenschaften für den virtuellen Computer fest, der in $VirtualMachine gespeichert ist.
Der Befehl verwendet die in $Credential gespeicherten Anmeldeinformationen.
Der Befehl verwendet Variablen, die in früheren Befehlen für einige Parameter zugewiesen wurden.
Der Befehl legt den Patchmoduswert auf dem virtuellen Computer auf "AutomaticByPlatform" fest.
Parameter
-AssessmentMode
Wert des automatischen Bewertungsmodus für den virtuellen Computer. Mögliche Werte sind ImageDefault und AutomaticByPlatform.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Gibt den Namen des Computers an.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Gibt den Benutzernamen und das Kennwort für den virtuellen Computer als PSCredential-Objekt an.
Verwenden Sie zum Abrufen von Anmeldeinformationen das Cmdlet "Get-Credential".
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential
.
Type: | PSCredential |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CustomData
Gibt eine Zeichenfolge an, die an den virtuellen Computer übergeben werden soll. Weitere Informationen finden Sie unter Custom Data on Azure VMs. Hinweis: Es wird nicht empfohlen, vertrauliche Informationen in benutzerdefinierten Daten zu speichern.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisablePasswordAuthentication
Gibt an, dass dieses Cmdlet die Kennwortauthentifizierung deaktiviert.
Type: | SwitchParameter |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisableVMAgent
Deaktivieren Sie den VM-Agent für die Bereitstellung.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutoUpdate
Gibt an, dass dieses Cmdlet die automatische Aktualisierung aktiviert.
Type: | SwitchParameter |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableHotpatching
Ermöglicht Es Kunden, ihre Azure-VMs zu patchen, ohne dass ein Neustart erforderlich ist. Für enableHotpatching muss "provisionVMAgent" auf "true" festgelegt werden, und "patchMode" muss auf "AutomaticByPlatform" festgelegt werden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Linux
Gibt an, dass der Typ des Betriebssystems Linux ist.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PatchMode
Gibt den Modus des In-Guest-Patchings auf den virtuellen IaaS-Computer an.
Dabei sind folgende Werte möglich:
AutomaticByPlatform – Patchinstallation für den virtuellen Computer wird von Azure verwaltet. Verwendung mit -Windows oder -Linux. Erfordert -ProvisionVMAgent. Erfordert "-EnableAutoUpdate" bei Verwendung mit -Windows.
AutomaticByOS – Patchinstallation für den virtuellen Computer wird vom Betriebssystem verwaltet. Wird mit -Windows verwendet. Erfordert -ProvisionVMAgent und -EnableAutoUpdate.
Manuell – Sie steuern die Anwendung von Patches auf einen virtuellen Computer. Wird mit -Windows verwendet. Erfordert -ProvisionVMAgent.
ImageDefault – Patchinstallation, die von den Standardeinstellungen im Betriebssystemimage verwaltet wird. Verwendung mit -Linux.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProvisionVMAgent
Gibt an, dass die Einstellungen erfordern, dass der Agent des virtuellen Computers auf dem virtuellen Computer installiert ist.
Type: | SwitchParameter |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeZone
Gibt die Zeitzone des virtuellen Computers an. z.B. "Pacific Standard Time".
Mögliche Werte können TimeZoneInfo.Id Wert aus Zeitzonen sein, die von TimeZoneInfo.GetSystemTimeZones zurückgegeben werden.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Gibt das objekt des lokalen virtuellen Computers an, für das Betriebssystemeigenschaften festgelegt werden sollen. Verwenden Sie das Cmdlet "Get-AzVM", um ein Objekt eines virtuellen Computers abzurufen. Erstellen Sie ein Objekt eines virtuellen Computers mithilfe des Cmdlets New-AzVMConfig.
Type: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Windows
Gibt an, dass der Typ des Betriebssystems Windows ist.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMCertificateUrl
Gibt den URI eines WinRM-Zertifikats an. Dies muss in einem Key Vault gespeichert werden.
Type: | Uri |
Position: | 10 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMHttp
Gibt an, dass dieses Betriebssystem HTTP WinRM verwendet.
Type: | SwitchParameter |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMHttps
Gibt an, dass dieses Betriebssystem HTTPS WinRM verwendet.
Type: | SwitchParameter |
Position: | 9 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |