Virtual Machines - Update

Dienst:

Compute

API-Version:

2024-07-01

Der Vorgang zum Aktualisieren eines virtuellen Computers.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2024-07-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string	Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
vmName	path	True	string	Der Name des virtuellen Computers.
api-version	query	True	string	Client-API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-Match		string	Das ETag der Transformation. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.
If-None-Match		string	Legen Sie auf '*' fest, damit ein neuer Datensatzsatz erstellt werden kann, aber um zu verhindern, dass ein vorhandener Datensatzsatz aktualisiert wird. Andere Werte führen zu Einem Fehler vom Server, da sie nicht unterstützt werden.

Anforderungstext

Name	Typ	Beschreibung
parameters	VirtualMachineUpdate	Parameter, die für den Update Virtual Machine-Vorgang bereitgestellt werden.

Antworten

Name	Typ	Beschreibung
200 OK	VirtualMachine	OKAY
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Update a VM by detaching data disk

Update a VM by force-detaching data disk

Update a VM by detaching data disk

Beispielanforderung

HTTP

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?api-version=2024-07-01

{
  "properties": {
    "hardwareProfile": {
      "vmSize": "Standard_D2_v2"
    },
    "storageProfile": {
      "imageReference": {
        "sku": "2016-Datacenter",
        "publisher": "MicrosoftWindowsServer",
        "version": "latest",
        "offer": "WindowsServer"
      },
      "osDisk": {
        "caching": "ReadWrite",
        "managedDisk": {
          "storageAccountType": "Standard_LRS"
        },
        "name": "myVMosdisk",
        "createOption": "FromImage"
      },
      "dataDisks": [
        {
          "diskSizeGB": 1023,
          "createOption": "Empty",
          "lun": 0,
          "toBeDetached": true
        },
        {
          "diskSizeGB": 1023,
          "createOption": "Empty",
          "lun": 1,
          "toBeDetached": false
        }
      ]
    },
    "osProfile": {
      "adminUsername": "{your-username}",
      "computerName": "myVM",
      "adminPassword": "{your-password}"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
          "properties": {
            "primary": true
          }
        }
      ]
    }
  }
}

Java

import com.azure.resourcemanager.compute.fluent.models.VirtualMachineUpdateInner;
import com.azure.resourcemanager.compute.models.CachingTypes;
import com.azure.resourcemanager.compute.models.DataDisk;
import com.azure.resourcemanager.compute.models.DiskCreateOptionTypes;
import com.azure.resourcemanager.compute.models.HardwareProfile;
import com.azure.resourcemanager.compute.models.ImageReference;
import com.azure.resourcemanager.compute.models.ManagedDiskParameters;
import com.azure.resourcemanager.compute.models.NetworkInterfaceReference;
import com.azure.resourcemanager.compute.models.NetworkProfile;
import com.azure.resourcemanager.compute.models.OSDisk;
import com.azure.resourcemanager.compute.models.OSProfile;
import com.azure.resourcemanager.compute.models.StorageAccountTypes;
import com.azure.resourcemanager.compute.models.StorageProfile;
import com.azure.resourcemanager.compute.models.VirtualMachineSizeTypes;
import java.util.Arrays;

/**
 * Samples for VirtualMachines Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineExamples/VirtualMachine_Update_DetachDataDiskUsingToBeDetachedProperty.json
     */
    /**
     * Sample code: Update a VM by detaching data disk.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAVMByDetachingDataDisk(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().update("myResourceGroup", "myVM",
            new VirtualMachineUpdateInner()
                .withHardwareProfile(new HardwareProfile().withVmSize(VirtualMachineSizeTypes.STANDARD_D2_V2))
                .withStorageProfile(new StorageProfile()
                    .withImageReference(new ImageReference().withPublisher("MicrosoftWindowsServer")
                        .withOffer("WindowsServer").withSku("2016-Datacenter").withVersion("latest"))
                    .withOsDisk(new OSDisk().withName("myVMosdisk").withCaching(CachingTypes.READ_WRITE)
                        .withCreateOption(DiskCreateOptionTypes.FROM_IMAGE).withManagedDisk(
                            new ManagedDiskParameters().withStorageAccountType(StorageAccountTypes.STANDARD_LRS)))
                    .withDataDisks(Arrays.asList(
                        new DataDisk().withLun(0).withCreateOption(DiskCreateOptionTypes.EMPTY).withDiskSizeGB(1023)
                            .withToBeDetached(true),
                        new DataDisk().withLun(1).withCreateOption(DiskCreateOptionTypes.EMPTY).withDiskSizeGB(1023)
                            .withToBeDetached(false))))
                .withOsProfile(new OSProfile().withComputerName("myVM").withAdminUsername("{your-username}")
                    .withAdminPassword("fakeTokenPlaceholder"))
                .withNetworkProfile(
                    new NetworkProfile().withNetworkInterfaces(Arrays.asList(new NetworkInterfaceReference().withId(
                        "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}")
                        .withPrimary(true)))),
            null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_update_detach_data_disk_using_to_be_detached_property.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machines.begin_update(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
        parameters={
            "properties": {
                "hardwareProfile": {"vmSize": "Standard_D2_v2"},
                "networkProfile": {
                    "networkInterfaces": [
                        {
                            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
                            "properties": {"primary": True},
                        }
                    ]
                },
                "osProfile": {
                    "adminPassword": "{your-password}",
                    "adminUsername": "{your-username}",
                    "computerName": "myVM",
                },
                "storageProfile": {
                    "dataDisks": [
                        {"createOption": "Empty", "diskSizeGB": 1023, "lun": 0, "toBeDetached": True},
                        {"createOption": "Empty", "diskSizeGB": 1023, "lun": 1, "toBeDetached": False},
                    ],
                    "imageReference": {
                        "offer": "WindowsServer",
                        "publisher": "MicrosoftWindowsServer",
                        "sku": "2016-Datacenter",
                        "version": "latest",
                    },
                    "osDisk": {
                        "caching": "ReadWrite",
                        "createOption": "FromImage",
                        "managedDisk": {"storageAccountType": "Standard_LRS"},
                        "name": "myVMosdisk",
                    },
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_DetachDataDiskUsingToBeDetachedProperty.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_DetachDataDiskUsingToBeDetachedProperty.json
func ExampleVirtualMachinesClient_BeginUpdate_updateAVmByDetachingDataDisk() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVirtualMachinesClient().BeginUpdate(ctx, "myResourceGroup", "myVM", armcompute.VirtualMachineUpdate{
		Properties: &armcompute.VirtualMachineProperties{
			HardwareProfile: &armcompute.HardwareProfile{
				VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardD2V2),
			},
			NetworkProfile: &armcompute.NetworkProfile{
				NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
					{
						ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}"),
						Properties: &armcompute.NetworkInterfaceReferenceProperties{
							Primary: to.Ptr(true),
						},
					}},
			},
			OSProfile: &armcompute.OSProfile{
				AdminPassword: to.Ptr("{your-password}"),
				AdminUsername: to.Ptr("{your-username}"),
				ComputerName:  to.Ptr("myVM"),
			},
			StorageProfile: &armcompute.StorageProfile{
				DataDisks: []*armcompute.DataDisk{
					{
						CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
						DiskSizeGB:   to.Ptr[int32](1023),
						Lun:          to.Ptr[int32](0),
						ToBeDetached: to.Ptr(true),
					},
					{
						CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
						DiskSizeGB:   to.Ptr[int32](1023),
						Lun:          to.Ptr[int32](1),
						ToBeDetached: to.Ptr(false),
					}},
				ImageReference: &armcompute.ImageReference{
					Offer:     to.Ptr("WindowsServer"),
					Publisher: to.Ptr("MicrosoftWindowsServer"),
					SKU:       to.Ptr("2016-Datacenter"),
					Version:   to.Ptr("latest"),
				},
				OSDisk: &armcompute.OSDisk{
					Name:         to.Ptr("myVMosdisk"),
					Caching:      to.Ptr(armcompute.CachingTypesReadWrite),
					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
					ManagedDisk: &armcompute.ManagedDiskParameters{
						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
					},
				},
			},
		},
	}, &armcompute.VirtualMachinesClientBeginUpdateOptions{IfMatch: nil,
		IfNoneMatch: nil,
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachine = armcompute.VirtualMachine{
	// 	Name: to.Ptr("myVM"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 	Location: to.Ptr("westus"),
	// 	Properties: &armcompute.VirtualMachineProperties{
	// 		HardwareProfile: &armcompute.HardwareProfile{
	// 			VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardD2V2),
	// 		},
	// 		NetworkProfile: &armcompute.NetworkProfile{
	// 			NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/nsgExistingNic"),
	// 					Properties: &armcompute.NetworkInterfaceReferenceProperties{
	// 						Primary: to.Ptr(true),
	// 					},
	// 			}},
	// 		},
	// 		OSProfile: &armcompute.OSProfile{
	// 			AdminUsername: to.Ptr("{your-username}"),
	// 			ComputerName: to.Ptr("myVM"),
	// 			Secrets: []*armcompute.VaultSecretGroup{
	// 			},
	// 			WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 				EnableAutomaticUpdates: to.Ptr(true),
	// 				ProvisionVMAgent: to.Ptr(true),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		StorageProfile: &armcompute.StorageProfile{
	// 			DataDisks: []*armcompute.DataDisk{
	// 				{
	// 					Caching: to.Ptr(armcompute.CachingTypesNone),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					DiskSizeGB: to.Ptr[int32](1023),
	// 					Lun: to.Ptr[int32](0),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 					},
	// 					ToBeDetached: to.Ptr(true),
	// 				},
	// 				{
	// 					Caching: to.Ptr(armcompute.CachingTypesNone),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					DiskSizeGB: to.Ptr[int32](1023),
	// 					Lun: to.Ptr[int32](1),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 					},
	// 					ToBeDetached: to.Ptr(false),
	// 			}},
	// 			ImageReference: &armcompute.ImageReference{
	// 				Offer: to.Ptr("WindowsServer"),
	// 				Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 				SKU: to.Ptr("2016-Datacenter"),
	// 				Version: to.Ptr("latest"),
	// 			},
	// 			OSDisk: &armcompute.OSDisk{
	// 				Name: to.Ptr("myVMosdisk"),
	// 				Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 				CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 				ManagedDisk: &armcompute.ManagedDiskParameters{
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 				},
	// 				OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 			},
	// 		},
	// 		VMID: to.Ptr("3906fef9-a1e5-4b83-a8a8-540858b41df0"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to The operation to update a virtual machine.
 *
 * @summary The operation to update a virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_DetachDataDiskUsingToBeDetachedProperty.json
 */
async function updateAVMByDetachingDataDisk() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmName = "myVM";
  const parameters = {
    hardwareProfile: { vmSize: "Standard_D2_v2" },
    networkProfile: {
      networkInterfaces: [
        {
          id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
          primary: true,
        },
      ],
    },
    osProfile: {
      adminPassword: "{your-password}",
      adminUsername: "{your-username}",
      computerName: "myVM",
    },
    storageProfile: {
      dataDisks: [
        { createOption: "Empty", diskSizeGB: 1023, lun: 0, toBeDetached: true },
        {
          createOption: "Empty",
          diskSizeGB: 1023,
          lun: 1,
          toBeDetached: false,
        },
      ],
      imageReference: {
        offer: "WindowsServer",
        publisher: "MicrosoftWindowsServer",
        sku: "2016-Datacenter",
        version: "latest",
      },
      osDisk: {
        name: "myVMosdisk",
        caching: "ReadWrite",
        createOption: "FromImage",
        managedDisk: { storageAccountType: "Standard_LRS" },
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.beginUpdateAndWait(
    resourceGroupName,
    vmName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_DetachDataDiskUsingToBeDetachedProperty.json
// this example is just showing the usage of "VirtualMachines_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineResource created on azure
// for more information of creating VirtualMachineResource, please refer to the document of VirtualMachineResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string vmName = "myVM";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
VirtualMachinePatch patch = new VirtualMachinePatch
{
    HardwareProfile = new VirtualMachineHardwareProfile
    {
        VmSize = VirtualMachineSizeType.StandardD2V2,
    },
    StorageProfile = new VirtualMachineStorageProfile
    {
        ImageReference = new ImageReference
        {
            Publisher = "MicrosoftWindowsServer",
            Offer = "WindowsServer",
            Sku = "2016-Datacenter",
            Version = "latest",
        },
        OSDisk = new VirtualMachineOSDisk(DiskCreateOptionType.FromImage)
        {
            Name = "myVMosdisk",
            Caching = CachingType.ReadWrite,
            ManagedDisk = new VirtualMachineManagedDisk
            {
                StorageAccountType = StorageAccountType.StandardLrs,
            },
        },
        DataDisks = {new VirtualMachineDataDisk(0, DiskCreateOptionType.Empty)
        {
        DiskSizeGB = 1023,
        ToBeDetached = true,
        }, new VirtualMachineDataDisk(1, DiskCreateOptionType.Empty)
        {
        DiskSizeGB = 1023,
        ToBeDetached = false,
        }},
    },
    OSProfile = new VirtualMachineOSProfile
    {
        ComputerName = "myVM",
        AdminUsername = "{your-username}",
        AdminPassword = "{your-password}",
    },
    NetworkProfile = new VirtualMachineNetworkProfile
    {
        NetworkInterfaces = {new VirtualMachineNetworkInterfaceReference
        {
        Primary = true,
        Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}"),
        }},
    },
};
ArmOperation<VirtualMachineResource> lro = await virtualMachine.UpdateAsync(WaitUntil.Completed, patch);
VirtualMachineResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
VirtualMachineData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
  "type": "Microsoft.Compute/virtualMachines",
  "properties": {
    "osProfile": {
      "adminUsername": "{your-username}",
      "secrets": [],
      "computerName": "myVM",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": true
      }
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/nsgExistingNic",
          "properties": {
            "primary": true
          }
        }
      ]
    },
    "storageProfile": {
      "imageReference": {
        "sku": "2016-Datacenter",
        "publisher": "MicrosoftWindowsServer",
        "version": "latest",
        "offer": "WindowsServer"
      },
      "osDisk": {
        "osType": "Windows",
        "caching": "ReadWrite",
        "createOption": "FromImage",
        "name": "myVMosdisk",
        "managedDisk": {
          "storageAccountType": "Standard_LRS"
        }
      },
      "dataDisks": [
        {
          "caching": "None",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "Empty",
          "lun": 0,
          "diskSizeGB": 1023,
          "toBeDetached": true
        },
        {
          "caching": "None",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "Empty",
          "lun": 1,
          "diskSizeGB": 1023,
          "toBeDetached": false
        }
      ]
    },
    "vmId": "3906fef9-a1e5-4b83-a8a8-540858b41df0",
    "hardwareProfile": {
      "vmSize": "Standard_D2_v2"
    },
    "provisioningState": "Updating"
  },
  "name": "myVM",
  "location": "westus"
}

Update a VM by force-detaching data disk

Beispielanforderung

HTTP

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?api-version=2024-07-01

{
  "properties": {
    "hardwareProfile": {
      "vmSize": "Standard_D2_v2"
    },
    "storageProfile": {
      "imageReference": {
        "sku": "2016-Datacenter",
        "publisher": "MicrosoftWindowsServer",
        "version": "latest",
        "offer": "WindowsServer"
      },
      "osDisk": {
        "caching": "ReadWrite",
        "managedDisk": {
          "storageAccountType": "Standard_LRS"
        },
        "name": "myVMosdisk",
        "createOption": "FromImage"
      },
      "dataDisks": [
        {
          "diskSizeGB": 1023,
          "createOption": "Empty",
          "lun": 0,
          "toBeDetached": true,
          "detachOption": "ForceDetach"
        },
        {
          "diskSizeGB": 1023,
          "createOption": "Empty",
          "lun": 1,
          "toBeDetached": false
        }
      ]
    },
    "osProfile": {
      "adminUsername": "{your-username}",
      "computerName": "myVM",
      "adminPassword": "{your-password}"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
          "properties": {
            "primary": true
          }
        }
      ]
    }
  }
}

Java

import com.azure.resourcemanager.compute.fluent.models.VirtualMachineUpdateInner;
import com.azure.resourcemanager.compute.models.CachingTypes;
import com.azure.resourcemanager.compute.models.DataDisk;
import com.azure.resourcemanager.compute.models.DiskCreateOptionTypes;
import com.azure.resourcemanager.compute.models.DiskDetachOptionTypes;
import com.azure.resourcemanager.compute.models.HardwareProfile;
import com.azure.resourcemanager.compute.models.ImageReference;
import com.azure.resourcemanager.compute.models.ManagedDiskParameters;
import com.azure.resourcemanager.compute.models.NetworkInterfaceReference;
import com.azure.resourcemanager.compute.models.NetworkProfile;
import com.azure.resourcemanager.compute.models.OSDisk;
import com.azure.resourcemanager.compute.models.OSProfile;
import com.azure.resourcemanager.compute.models.StorageAccountTypes;
import com.azure.resourcemanager.compute.models.StorageProfile;
import com.azure.resourcemanager.compute.models.VirtualMachineSizeTypes;
import java.util.Arrays;

/**
 * Samples for VirtualMachines Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineExamples/VirtualMachine_Update_ForceDetachDataDisk.json
     */
    /**
     * Sample code: Update a VM by force-detaching data disk.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAVMByForceDetachingDataDisk(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().update("myResourceGroup", "myVM",
            new VirtualMachineUpdateInner()
                .withHardwareProfile(new HardwareProfile().withVmSize(VirtualMachineSizeTypes.STANDARD_D2_V2))
                .withStorageProfile(new StorageProfile()
                    .withImageReference(new ImageReference().withPublisher("MicrosoftWindowsServer")
                        .withOffer("WindowsServer").withSku("2016-Datacenter").withVersion("latest"))
                    .withOsDisk(new OSDisk().withName("myVMosdisk").withCaching(CachingTypes.READ_WRITE)
                        .withCreateOption(DiskCreateOptionTypes.FROM_IMAGE).withManagedDisk(
                            new ManagedDiskParameters().withStorageAccountType(StorageAccountTypes.STANDARD_LRS)))
                    .withDataDisks(Arrays.asList(
                        new DataDisk().withLun(0).withCreateOption(DiskCreateOptionTypes.EMPTY).withDiskSizeGB(1023)
                            .withToBeDetached(true).withDetachOption(DiskDetachOptionTypes.FORCE_DETACH),
                        new DataDisk().withLun(1).withCreateOption(DiskCreateOptionTypes.EMPTY).withDiskSizeGB(1023)
                            .withToBeDetached(false))))
                .withOsProfile(new OSProfile().withComputerName("myVM").withAdminUsername("{your-username}")
                    .withAdminPassword("fakeTokenPlaceholder"))
                .withNetworkProfile(
                    new NetworkProfile().withNetworkInterfaces(Arrays.asList(new NetworkInterfaceReference().withId(
                        "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}")
                        .withPrimary(true)))),
            null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_update_force_detach_data_disk.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machines.begin_update(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
        parameters={
            "properties": {
                "hardwareProfile": {"vmSize": "Standard_D2_v2"},
                "networkProfile": {
                    "networkInterfaces": [
                        {
                            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
                            "properties": {"primary": True},
                        }
                    ]
                },
                "osProfile": {
                    "adminPassword": "{your-password}",
                    "adminUsername": "{your-username}",
                    "computerName": "myVM",
                },
                "storageProfile": {
                    "dataDisks": [
                        {
                            "createOption": "Empty",
                            "detachOption": "ForceDetach",
                            "diskSizeGB": 1023,
                            "lun": 0,
                            "toBeDetached": True,
                        },
                        {"createOption": "Empty", "diskSizeGB": 1023, "lun": 1, "toBeDetached": False},
                    ],
                    "imageReference": {
                        "offer": "WindowsServer",
                        "publisher": "MicrosoftWindowsServer",
                        "sku": "2016-Datacenter",
                        "version": "latest",
                    },
                    "osDisk": {
                        "caching": "ReadWrite",
                        "createOption": "FromImage",
                        "managedDisk": {"storageAccountType": "Standard_LRS"},
                        "name": "myVMosdisk",
                    },
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_ForceDetachDataDisk.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_ForceDetachDataDisk.json
func ExampleVirtualMachinesClient_BeginUpdate_updateAVmByForceDetachingDataDisk() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVirtualMachinesClient().BeginUpdate(ctx, "myResourceGroup", "myVM", armcompute.VirtualMachineUpdate{
		Properties: &armcompute.VirtualMachineProperties{
			HardwareProfile: &armcompute.HardwareProfile{
				VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardD2V2),
			},
			NetworkProfile: &armcompute.NetworkProfile{
				NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
					{
						ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}"),
						Properties: &armcompute.NetworkInterfaceReferenceProperties{
							Primary: to.Ptr(true),
						},
					}},
			},
			OSProfile: &armcompute.OSProfile{
				AdminPassword: to.Ptr("{your-password}"),
				AdminUsername: to.Ptr("{your-username}"),
				ComputerName:  to.Ptr("myVM"),
			},
			StorageProfile: &armcompute.StorageProfile{
				DataDisks: []*armcompute.DataDisk{
					{
						CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
						DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
						DiskSizeGB:   to.Ptr[int32](1023),
						Lun:          to.Ptr[int32](0),
						ToBeDetached: to.Ptr(true),
					},
					{
						CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
						DiskSizeGB:   to.Ptr[int32](1023),
						Lun:          to.Ptr[int32](1),
						ToBeDetached: to.Ptr(false),
					}},
				ImageReference: &armcompute.ImageReference{
					Offer:     to.Ptr("WindowsServer"),
					Publisher: to.Ptr("MicrosoftWindowsServer"),
					SKU:       to.Ptr("2016-Datacenter"),
					Version:   to.Ptr("latest"),
				},
				OSDisk: &armcompute.OSDisk{
					Name:         to.Ptr("myVMosdisk"),
					Caching:      to.Ptr(armcompute.CachingTypesReadWrite),
					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
					ManagedDisk: &armcompute.ManagedDiskParameters{
						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
					},
				},
			},
		},
	}, &armcompute.VirtualMachinesClientBeginUpdateOptions{IfMatch: nil,
		IfNoneMatch: nil,
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachine = armcompute.VirtualMachine{
	// 	Name: to.Ptr("myVM"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 	Location: to.Ptr("westus"),
	// 	Properties: &armcompute.VirtualMachineProperties{
	// 		HardwareProfile: &armcompute.HardwareProfile{
	// 			VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardD2V2),
	// 		},
	// 		NetworkProfile: &armcompute.NetworkProfile{
	// 			NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/nsgExistingNic"),
	// 					Properties: &armcompute.NetworkInterfaceReferenceProperties{
	// 						Primary: to.Ptr(true),
	// 					},
	// 			}},
	// 		},
	// 		OSProfile: &armcompute.OSProfile{
	// 			AdminUsername: to.Ptr("{your-username}"),
	// 			ComputerName: to.Ptr("myVM"),
	// 			Secrets: []*armcompute.VaultSecretGroup{
	// 			},
	// 			WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 				EnableAutomaticUpdates: to.Ptr(true),
	// 				ProvisionVMAgent: to.Ptr(true),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		StorageProfile: &armcompute.StorageProfile{
	// 			DataDisks: []*armcompute.DataDisk{
	// 				{
	// 					Caching: to.Ptr(armcompute.CachingTypesNone),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
	// 					DiskSizeGB: to.Ptr[int32](1023),
	// 					Lun: to.Ptr[int32](0),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 					},
	// 					ToBeDetached: to.Ptr(true),
	// 				},
	// 				{
	// 					Caching: to.Ptr(armcompute.CachingTypesNone),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					DiskSizeGB: to.Ptr[int32](1023),
	// 					Lun: to.Ptr[int32](1),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 					},
	// 					ToBeDetached: to.Ptr(false),
	// 			}},
	// 			ImageReference: &armcompute.ImageReference{
	// 				Offer: to.Ptr("WindowsServer"),
	// 				Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 				SKU: to.Ptr("2016-Datacenter"),
	// 				Version: to.Ptr("latest"),
	// 			},
	// 			OSDisk: &armcompute.OSDisk{
	// 				Name: to.Ptr("myVMosdisk"),
	// 				Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 				CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 				ManagedDisk: &armcompute.ManagedDiskParameters{
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 				},
	// 				OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 			},
	// 		},
	// 		VMID: to.Ptr("3906fef9-a1e5-4b83-a8a8-540858b41df0"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to The operation to update a virtual machine.
 *
 * @summary The operation to update a virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_ForceDetachDataDisk.json
 */
async function updateAVMByForceDetachingDataDisk() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmName = "myVM";
  const parameters = {
    hardwareProfile: { vmSize: "Standard_D2_v2" },
    networkProfile: {
      networkInterfaces: [
        {
          id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
          primary: true,
        },
      ],
    },
    osProfile: {
      adminPassword: "{your-password}",
      adminUsername: "{your-username}",
      computerName: "myVM",
    },
    storageProfile: {
      dataDisks: [
        {
          createOption: "Empty",
          detachOption: "ForceDetach",
          diskSizeGB: 1023,
          lun: 0,
          toBeDetached: true,
        },
        {
          createOption: "Empty",
          diskSizeGB: 1023,
          lun: 1,
          toBeDetached: false,
        },
      ],
      imageReference: {
        offer: "WindowsServer",
        publisher: "MicrosoftWindowsServer",
        sku: "2016-Datacenter",
        version: "latest",
      },
      osDisk: {
        name: "myVMosdisk",
        caching: "ReadWrite",
        createOption: "FromImage",
        managedDisk: { storageAccountType: "Standard_LRS" },
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.beginUpdateAndWait(
    resourceGroupName,
    vmName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_Update_ForceDetachDataDisk.json
// this example is just showing the usage of "VirtualMachines_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineResource created on azure
// for more information of creating VirtualMachineResource, please refer to the document of VirtualMachineResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string vmName = "myVM";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
VirtualMachinePatch patch = new VirtualMachinePatch
{
    HardwareProfile = new VirtualMachineHardwareProfile
    {
        VmSize = VirtualMachineSizeType.StandardD2V2,
    },
    StorageProfile = new VirtualMachineStorageProfile
    {
        ImageReference = new ImageReference
        {
            Publisher = "MicrosoftWindowsServer",
            Offer = "WindowsServer",
            Sku = "2016-Datacenter",
            Version = "latest",
        },
        OSDisk = new VirtualMachineOSDisk(DiskCreateOptionType.FromImage)
        {
            Name = "myVMosdisk",
            Caching = CachingType.ReadWrite,
            ManagedDisk = new VirtualMachineManagedDisk
            {
                StorageAccountType = StorageAccountType.StandardLrs,
            },
        },
        DataDisks = {new VirtualMachineDataDisk(0, DiskCreateOptionType.Empty)
        {
        DiskSizeGB = 1023,
        ToBeDetached = true,
        DetachOption = DiskDetachOptionType.ForceDetach,
        }, new VirtualMachineDataDisk(1, DiskCreateOptionType.Empty)
        {
        DiskSizeGB = 1023,
        ToBeDetached = false,
        }},
    },
    OSProfile = new VirtualMachineOSProfile
    {
        ComputerName = "myVM",
        AdminUsername = "{your-username}",
        AdminPassword = "{your-password}",
    },
    NetworkProfile = new VirtualMachineNetworkProfile
    {
        NetworkInterfaces = {new VirtualMachineNetworkInterfaceReference
        {
        Primary = true,
        Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}"),
        }},
    },
};
ArmOperation<VirtualMachineResource> lro = await virtualMachine.UpdateAsync(WaitUntil.Completed, patch);
VirtualMachineResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
VirtualMachineData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
  "type": "Microsoft.Compute/virtualMachines",
  "properties": {
    "osProfile": {
      "adminUsername": "{your-username}",
      "secrets": [],
      "computerName": "myVM",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": true
      }
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/nsgExistingNic",
          "properties": {
            "primary": true
          }
        }
      ]
    },
    "storageProfile": {
      "imageReference": {
        "sku": "2016-Datacenter",
        "publisher": "MicrosoftWindowsServer",
        "version": "latest",
        "offer": "WindowsServer"
      },
      "osDisk": {
        "osType": "Windows",
        "caching": "ReadWrite",
        "createOption": "FromImage",
        "name": "myVMosdisk",
        "managedDisk": {
          "storageAccountType": "Standard_LRS"
        }
      },
      "dataDisks": [
        {
          "caching": "None",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "Empty",
          "lun": 0,
          "diskSizeGB": 1023,
          "toBeDetached": true,
          "detachOption": "ForceDetach"
        },
        {
          "caching": "None",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "Empty",
          "lun": 1,
          "diskSizeGB": 1023,
          "toBeDetached": false
        }
      ]
    },
    "vmId": "3906fef9-a1e5-4b83-a8a8-540858b41df0",
    "hardwareProfile": {
      "vmSize": "Standard_D2_v2"
    },
    "provisioningState": "Updating"
  },
  "name": "myVM",
  "location": "westus"
}

Definitionen

Name	Beschreibung
AdditionalCapabilities	Gibt zusätzliche Funktionen an, die auf dem virtuellen Computer aktiviert oder deaktiviert sind.
AdditionalUnattendContent	Gibt zusätzliche base64-codierte XML-formatierte Informationen an, die in der Unattend.xml-Datei enthalten sein können, die von Windows Setup verwendet wird.
ApiEntityReference	Der Quellressourcenbezeichner. Dabei kann es sich um einen Momentaufnahme- oder Datenträgerwiederherstellungspunkt zum Erstellen eines Datenträgers sein.
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
ApplicationProfile	Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.
AvailablePatchSummary	Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer.
BillingProfile	Gibt die abrechnungsbezogenen Details eines virtuellen Azure Spot-Computers an. Mindest-API-Version: 2019-03-01.
BootDiagnostics	Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. HINWEIS: Wenn "storageUri" angegeben wird, stellen Sie sicher, dass sich das Speicherkonto in derselben Region und im selben Abonnement wie der virtuelle Computer befindet. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.
BootDiagnosticsInstanceView	Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.
CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.
CapacityReservationProfile	Gibt Informationen zur Kapazitätsreservierung an, die zum Zuordnen virtueller Computer verwendet wird. Mindest-API-Version: 2021-04-01.
CloudError	Eine Fehlerantwort des Computediensts.
ComponentNames	Der Komponentenname. Derzeit ist der einzige zulässige Wert Microsoft-Windows-Shell-Setup.
DataDisk	Gibt die Parameter an, die zum Hinzufügen eines Datenträgers zu einem virtuellen Computer verwendet werden. Weitere Informationen zu Datenträgern finden Sie unter Informationen zu Datenträgern und VHDs für virtuelle Azure-Computer.
DeleteOptions	Angeben, was mit der Netzwerkschnittstelle passiert, wenn der virtuelle Computer gelöscht wird
DiagnosticsProfile	Gibt den Status der Startdiagnoseeinstellungen an. Mindest-API-Version: 2015-06-15.
DiffDiskOptions	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an.
DiffDiskPlacement	Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Mögliche Werte sind: CacheDisk,ResourceDisk,NvmeDisk. Das Standardverhalten lautet: CacheDisk, wenn eine für die VM-Größe konfiguriert ist, andernfalls ResourceDisk oder NvmeDisk- verwendet wird. In der Vm-Größendokumentation für Windows-VM unter https://docs.microsoft.com/azure/virtual-machines/windows/sizes und Linux-VM unter https://docs.microsoft.com/azure/virtual-machines/linux/sizes können Sie überprüfen, welche VM-Größen einen Cachedatenträger verfügbar machen. Mindest-API-Version für NvmeDisk: 2024-03-01.
DiffDiskSettings	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird.
DiskControllerTypes	Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer konfiguriert ist. Hinweis: Diese Eigenschaft wird auf den Standarddatenträgertyp festgelegt, wenn kein angegebener virtueller Computer mit "hyperVGeneration" auf V2 basierend auf den Funktionen des Betriebssystemdatenträgers und der VM-Größe aus der angegebenen Mindest-API-Version erstellt wird. Sie müssen die Zuordnung des virtuellen Computers vor dem Aktualisieren des Datenträgercontrollertyps durchführen, es sei denn, Sie aktualisieren die VM-Größe in der VM-Konfiguration, die implizit zuordnungen und die VM neu zugeordnet. Mindest-API-Version: 2022-08-01.
DiskCreateOptionTypes	Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des virtuellen Computers verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden.
DiskDeleteOptionTypes	Gibt an, ob der Betriebssystemdatenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger gelöscht, wenn der virtuelle Computer gelöscht wird. Abtrennen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger nach dem Löschen des virtuellen Computers beibehalten. Der Standardwert ist auf Trennenfestgelegt. Bei einem kurzlebigen Betriebssystemdatenträger wird der Standardwert auf Deletefestgelegt. Der Benutzer kann die Löschoption für einen kurzlebigen Betriebssystemdatenträger nicht ändern.
DiskDetachOptionTypes	Gibt das Verhalten zum Trennen eines Datenträgers an, das beim Trennen eines Datenträgers verwendet werden soll oder das sich bereits im Prozess der Trennung vom virtuellen Computer befindet. Unterstützte Werte: ForceDetach. detachOption: ForceDetach gilt nur für verwaltete Datenträger. Wenn ein vorheriger Trennungsversuch des Datenträgers aufgrund eines unerwarteten Fehlers vom virtuellen Computer nicht abgeschlossen wurde und der Datenträger noch nicht freigegeben wird, verwenden Sie "Force-detach" als letzte Option zum Trennen des Datenträgers vom virtuellen Computer. Bei Verwendung dieses Trennverhaltens wurden möglicherweise nicht alle Schreibvorgänge geleert. Um das Trennen eines Datenträgerupdates auf "True" zu erzwingen, zusammen mit der Einstellung "tachOption: 'ForceDetach'"
DiskEncryptionSetParameters	Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an.
DiskEncryptionSettings	Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. Mindest-API-Version: 2015-06-15.
DiskInstanceView	Die Datenträgerinformationen des virtuellen Computers.
DomainNameLabelScopeTypes	Der Bereich der Domänenbezeichnung der PublicIPAddress-Ressourcen, die erstellt werden. Die generierte Namensbezeichnung ist die Verkettung der Hash-Domänennamenbezeichnung mit Richtlinie gemäß dem Bereich der Domänenbezeichnung und der eindeutigen ID des vm-Netzwerkprofils.
EncryptionIdentity	Gibt die verwaltete Identität an, die von ADE zum Abrufen des Zugriffstokens für Keyvault-Vorgänge verwendet wird.
EventGridAndResourceGraph	Die Konfigurationsparameter, die beim Erstellen der Ereigniseinstellung eventGridAndResourceGraph Scheduled Event verwendet werden.
ExtendedLocation	Der erweiterte Speicherort des virtuellen Computers.
ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.
HardwareProfile	Gibt die Hardwareeinstellungen für den virtuellen Computer an.
HyperVGenerationType	Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist.
ImageReference	Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder virtuellen Computerimages angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein virtuelles Computerimage verwenden möchten, aber nicht in anderen Erstellungsvorgängen verwendet wird.
InnerError	Innere Fehlerdetails.
InstanceViewStatus	Instanzansichtsstatus.
IPVersions	Ab Api-Version 2019-07-01 ist es verfügbar, ob es sich bei der spezifischen ipconfiguration um IPv4 oder IPv6 handelt. Der Standardwert wird als IPv4 verwendet. Mögliche Werte sind: "IPv4" und "IPv6".
KeyVaultKeyReference	Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels im Key Vault an.
KeyVaultSecretReference	Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden
LastPatchInstallationSummary	Die Installationszusammenfassung des neuesten Installationsvorgangs für den virtuellen Computer.
LinuxConfiguration	Gibt die Linux-Betriebssystemeinstellungen auf dem virtuellen Computer an. Eine Liste der unterstützten Linux-Distributionen finden Sie unter Linux unter Azure-Endorsed Distributionen.
LinuxPatchAssessmentMode	Gibt den Modus der VM-Gastpatchbewertung für den virtuellen IaaS-Computer an. Mögliche Werte sind: ImageDefault- – Sie steuern den Zeitpunkt der Patchbewertungen auf einem virtuellen Computer. AutomaticByPlatform – Die Plattform löst regelmäßige Patchbewertungen aus. Die Eigenschaft provisionVMAgent muss true sein.
LinuxPatchSettings	[Vorschaufeature] Gibt Einstellungen im Zusammenhang mit VM-Gastpatching unter Linux an.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Gibt die Neustarteinstellung für alle AutomaticByPlatform-Patchinstallationsvorgänge an.
LinuxVMGuestPatchAutomaticByPlatformSettings	Gibt zusätzliche Einstellungen für den Patchmodus AutomaticByPlatform in VM-Gastpatching unter Linux an.
LinuxVMGuestPatchMode	Gibt den Modus des VM-Gastpatchings auf iaaS-VM-Computer oder virtuelle Computer an, die mit orchestrationMode als flexibel verknüpft sind. Mögliche Werte sind: ImageDefault- – Die Standardpatchingkonfiguration des virtuellen Computers wird verwendet. AutomaticByPlatform – Der virtuelle Computer wird automatisch von der Plattform aktualisiert. Die Eigenschaft provisionVMAgent muss true sein.
MaintenanceOperationResultCodeTypes	Der letzte Ergebniscode des Wartungsvorgangs.
MaintenanceRedeployStatus	Der Wartungsvorgangsstatus auf dem virtuellen Computer.
ManagedDiskParameters	Die Parameter des verwalteten Datenträgers.
Mode	Gibt den Modus an, für den ProxyAgent ausgeführt wird, wenn das Feature aktiviert ist. ProxyAgent beginnt mit der Überwachung oder Überwachung, erzwingt jedoch keine Zugriffssteuerung für Anforderungen an Hostendpunkte im Überwachungsmodus, während im Erzwingungsmodus die Zugriffssteuerung erzwungen wird. Der Standardwert ist der Erzwingungsmodus.
NetworkApiVersion	Gibt die Microsoft.Network-API-Version an, die beim Erstellen von Netzwerkressourcen in den Netzwerkschnittstellenkonfigurationen verwendet wird.
NetworkInterfaceAuxiliaryMode	Gibt an, ob der Hilfsmodus für die Netzwerkschnittstellenressource aktiviert ist.
NetworkInterfaceAuxiliarySku	Gibt an, ob die Hilfssku für die Netzwerkschnittstellenressource aktiviert ist.
NetworkInterfaceReference	Gibt die Liste der Ressourcen-IDs für die Netzwerkschnittstellen an, die dem virtuellen Computer zugeordnet sind.
NetworkProfile	Gibt die Netzwerkschnittstellen des virtuellen Computers an.
OperatingSystemTypes	Der Betriebssystemtyp.
OSDisk	Gibt Informationen zum Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. Weitere Informationen zu Datenträgern finden Sie unter Informationen zu Datenträgern und VHDs für virtuelle Azure-Computer.
OSImageNotificationProfile	Gibt konfigurationen im Zusammenhang mit dem geplanten Betriebssystemimage an.
OSProfile	Gibt die Betriebssystemeinstellungen an, die beim Erstellen des virtuellen Computers verwendet werden. Einige der Einstellungen können nicht geändert werden, nachdem der virtuelle Computer bereitgestellt wurde.
PassNames	Der Passname. Derzeit ist der einzige zulässige Wert OobeSystem.
PatchOperationStatus	Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden.
PatchSettings	[Vorschaufeature] Gibt Einstellungen im Zusammenhang mit VM-Gastpatching unter Windows an.
Plan	Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Bilder verwendet. Bevor Sie ein Marketplace-Image aus einer API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal das Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Möchten Sie programmgesteuert bereitstellen, Erste Schritte –>. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.
ProtocolTypes	Gibt das Protokoll des WinRM-Listeners an. Mögliche Werte sind: http,https.
ProxyAgentSettings	Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an. Mindest-API-Version: 2023-09-01.
PublicIPAddressSku	Beschreibt die öffentliche IP-Sku. Er kann nur mit OrchestrationMode als flexibel festgelegt werden.
PublicIPAddressSkuName	Angeben des öffentlichen IP-Sku-Namens
PublicIPAddressSkuTier	Angeben der öffentlichen IP-Sku-Ebene
PublicIPAllocationMethod	Angeben des öffentlichen IP-Zuordnungstyps
ResourceIdentityType	Der Identitätstyp, der für den virtuellen Computer verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.
ScheduledEventsAdditionalPublishingTargets	Die Konfigurationsparameter, die beim Veröffentlichen von scheduledEventsAdditionalPublishingTargets verwendet werden.
ScheduledEventsPolicy	Gibt redeploy, Reboot und ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations for the virtual machine an.
ScheduledEventsProfile	Gibt geplante Ereigniskonfigurationen an.
securityEncryptionTypes	Gibt den EncryptionType des verwalteten Datenträgers an. Es ist für die Verschlüsselung des verwalteten Datenträgers auf DiskWithVMGuestStateState festgelegt, vmGuestStateOnly für die Verschlüsselung nur des VMGuestState-Blobs und NonPersistedTPM, um den Firmwarestatus im VMGuestState-Blob nicht beizubehalten. Hinweis: Sie kann nur für vertrauliche virtuelle Computer festgelegt werden.
SecurityProfile	Gibt die Sicherheitsbezogenen Profileinstellungen für den virtuellen Computer an.
SecurityTypes	Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. Das Standardverhalten lautet: UefiSettings wird nur aktiviert, wenn diese Eigenschaft festgelegt ist.
SettingNames	Gibt den Namen der Einstellung an, auf die der Inhalt angewendet wird. Mögliche Werte sind: FirstLogonCommands und AutoLogon.
SshConfiguration	Gibt die Ssh-Schlüsselkonfiguration für ein Linux-Betriebssystem an.
SshPublicKey	Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit linuxbasierten VMs verwendet werden.
StatusLevelTypes	Der Ebenencode.
StorageAccountTypes	Gibt den Speicherkontotyp für den verwalteten Datenträger an. HINWEIS: UltraSSD_LRS nur mit Datenträgern verwendet werden kann, kann sie nicht mit Betriebssystemdatenträgern verwendet werden.
StorageProfile	Gibt die Speichereinstellungen für die Datenträger des virtuellen Computers an.
SubResource	Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält.
TerminateNotificationProfile	Gibt terminbezogene Terminkonfigurationen an.
UefiSettings	Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. Mindest-API-Version: 2020-12-01.
UserAssignedIdentities	Die Liste der Benutzeridentitäten, die dem virtuellen Computer zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
UserInitiatedReboot	Die Konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedReboot"-Ereigniseinstellung verwendet werden.
UserInitiatedRedeploy	Die konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedRedeploy scheduled event setting creation" verwendet werden.
VaultCertificate	Die Liste der Schlüsseltresorverweise in SourceVault, die Zertifikate enthalten.
VaultSecretGroup	Gibt einen Satz von Zertifikaten an, die auf dem virtuellen Computer installiert werden sollen. Um Zertifikate auf einem virtuellen Computer zu installieren, empfiehlt es sich, die erweiterung des virtuellen Azure Key Vault-Computers für Linux oder die erweiterung des virtuellen Azure Key Vault-Computers für Windowszu verwenden.
VirtualHardDisk	Die virtuelle Festplatte.
VirtualMachine	Beschreibt einen virtuellen Computer.
VirtualMachineAgentInstanceView	Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird.
VirtualMachineEvictionPolicyTypes	Gibt die Eviction-Richtlinie für den virtuellen Azure Spot-Computer und den Azure Spot-Skalierungssatz an. Für virtuelle Azure Spot-Computer werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2019-03-01. Bei Azure Spot-Skalierungssätzen werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2017-10-30-preview.
VirtualMachineExtension	Die Ressourcen für die untergeordnete Erweiterung des virtuellen Computers.
VirtualMachineExtensionHandlerInstanceView	Die Instanzansicht der Erweiterungshandler für virtuelle Computer.
VirtualMachineExtensionInstanceView	Die Erweiterungsinstanzansicht des virtuellen Computers.
VirtualMachineHealthStatus	Der Integritätsstatus für den virtuellen Computer.
VirtualMachineIdentity	Die Identität des virtuellen Computers, falls konfiguriert.
VirtualMachineInstanceView	Die Instanzansicht des virtuellen Computers.
VirtualMachineIpTag	Die Liste der IP-Tags, die der öffentlichen IP-Adresse zugeordnet sind.
VirtualMachineNetworkInterfaceConfiguration	Gibt die Netzwerkkonfigurationen an, die zum Erstellen der Netzwerkressourcen für virtuelle Computer verwendet werden.
VirtualMachineNetworkInterfaceDnsSettingsConfiguration	Die DNS-Einstellungen, die auf die Netzwerkschnittstellen angewendet werden sollen.
VirtualMachineNetworkInterfaceIPConfiguration	Gibt die IP-Konfigurationen der Netzwerkschnittstelle an.
VirtualMachinePatchStatus	[Vorschaufeature] Der Status von Patchvorgängen für virtuelle Computer.
VirtualMachinePriorityTypes	Gibt die Priorität für den virtuellen Computer an. Mindest-API-Version: 2019-03-01
VirtualMachinePublicIPAddressConfiguration	Die publicIPAddressConfiguration.
VirtualMachinePublicIPAddressDnsSettingsConfiguration	Die dns-Einstellungen, die auf die publicIP-Adressen angewendet werden sollen.
VirtualMachineSizeTypes	Gibt die Größe des virtuellen Computers an. Der Enumerationsdatentyp ist derzeit veraltet und wird bis zum 23. Dezember 2023 entfernt. Die empfohlene Methode zum Abrufen der Liste der verfügbaren Größen ist die Verwendung dieser APIs: Auflisten aller verfügbaren Größe virtueller Computergrößen in einem Verfügbarkeitssatz, Auflisten aller verfügbaren größen virtueller Computer in einer Region, Auflisten aller verfügbaren Größen für virtuelle Computer zum Ändern der Größe. Weitere Informationen zu den Größen virtueller Computer finden Sie unter Größen für virtuelle Computer. Die verfügbaren VM-Größen sind von Region und Verfügbarkeitssatz abhängig.
VirtualMachineUpdate	Parameter, die für den Update Virtual Machine-Vorgang bereitgestellt werden.
VMDiskSecurityProfile	Gibt das Sicherheitsprofil für den verwalteten Datenträger an.
VMGalleryApplication	Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.
VMSizeProperties	Gibt die Eigenschaften zum Anpassen der Größe des virtuellen Computers an. Mindest-API-Version: 2021-07-01. Dieses Feature befindet sich weiterhin im Vorschaumodus und wird für VirtualMachineScaleSet nicht unterstützt. Weitere Informationen finden Sie in VM Customization.
WindowsConfiguration	Gibt die Windows-Betriebssystemeinstellungen auf dem virtuellen Computer an.
WindowsPatchAssessmentMode	Gibt den Modus der VM-Gastpatchbewertung für den virtuellen IaaS-Computer an. Mögliche Werte sind: ImageDefault- – Sie steuern den Zeitpunkt der Patchbewertungen auf einem virtuellen Computer. AutomaticByPlatform – Die Plattform löst regelmäßige Patchbewertungen aus. Die Eigenschaft provisionVMAgent muss true sein.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Gibt die Neustarteinstellung für alle AutomaticByPlatform-Patchinstallationsvorgänge an.
WindowsVMGuestPatchAutomaticByPlatformSettings	Gibt zusätzliche Einstellungen für den Patchmodus AutomaticByPlatform in VM-Gastpatching unter Windows an.
WindowsVMGuestPatchMode	Gibt den Modus des VM-Gastpatchings auf iaaS-VM-Computer oder virtuelle Computer an, die mit orchestrationMode als flexibel verknüpft sind. Mögliche Werte sind: Manuelle – Sie steuern die Anwendung von Patches auf einen virtuellen Computer. Dazu wenden Sie Patches manuell innerhalb des virtuellen Computers an. In diesem Modus sind automatische Updates deaktiviert; die Eigenschaft "WindowsConfiguration.enableAutomaticUpdates" muss "false" sein. AutomaticByOS- – Der virtuelle Computer wird automatisch vom Betriebssystem aktualisiert. Die Eigenschaft "WindowsConfiguration.enableAutomaticUpdates" muss "true" sein. AutomaticByPlatform – der virtuelle Computer wird automatisch von der Plattform aktualisiert. Die Eigenschaften provisionVMAgent und WindowsConfiguration.enableAutomaticUpdates müssen true sein.
WinRMConfiguration	Gibt die Windows-Remoteverwaltungslistener an. Dies ermöglicht Remote-Windows PowerShell.
WinRMListener	Die Liste der Windows-Remoteverwaltungslistener

AdditionalCapabilities

Gibt zusätzliche Funktionen an, die auf dem virtuellen Computer aktiviert oder deaktiviert sind.

Name	Typ	Beschreibung
hibernationEnabled	boolean	Das Kennzeichen, das die Ruhezustandsfunktion auf dem virtuellen Computer aktiviert oder deaktiviert.
ultraSSDEnabled	boolean	Das Kennzeichen, das eine Funktion aktiviert oder deaktiviert, um einen oder mehrere verwaltete Datenträger mit UltraSSD_LRS Speicherkontotyp auf dem virtuellen Computer oder VMSS zu verwenden. Verwaltete Datenträger mit Speicherkontotyp UltraSSD_LRS können einem virtuellen Computer oder einem Skalierungssatz für virtuelle Computer nur hinzugefügt werden, wenn diese Eigenschaft aktiviert ist.

AdditionalUnattendContent

Gibt zusätzliche base64-codierte XML-formatierte Informationen an, die in der Unattend.xml-Datei enthalten sein können, die von Windows Setup verwendet wird.

Name	Typ	Beschreibung
componentName	ComponentNames	Der Komponentenname. Derzeit ist der einzige zulässige Wert Microsoft-Windows-Shell-Setup.
content	string	Gibt den XML-formatierten Inhalt an, der der unattend.xml-Datei für den angegebenen Pfad und die angegebene Komponente hinzugefügt wird. Der XML-Code muss kleiner als 4 KB sein und das Stammelement für die einstellung oder das Feature enthalten, das eingefügt wird.
passName	PassNames	Der Passname. Derzeit ist der einzige zulässige Wert OobeSystem.
settingName	SettingNames	Gibt den Namen der Einstellung an, auf die der Inhalt angewendet wird. Mögliche Werte sind: FirstLogonCommands und AutoLogon.

ApiEntityReference

Der Quellressourcenbezeichner. Dabei kann es sich um einen Momentaufnahme- oder Datenträgerwiederherstellungspunkt zum Erstellen eines Datenträgers sein.

Name	Typ	Beschreibung
id	string	Die ARM-Ressourcen-ID in Form von /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Die API-Fehlerdetails
innererror	InnerError	Interner API-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApplicationProfile

Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.

Name	Typ	Beschreibung
galleryApplications	VMGalleryApplication[]	Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.

AvailablePatchSummary

Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer.

Name	Typ	Beschreibung
assessmentActivityId	string	Die Aktivitäts-ID des Vorgangs, der dieses Ergebnis erzeugt hat. Es wird verwendet, um in CRP- und Erweiterungsprotokollen zu korrelieren.
criticalAndSecurityPatchCount	integer	Die Anzahl kritischer oder Sicherheitspatches, die als verfügbar erkannt und noch nicht installiert wurden.
error	ApiError	Die Fehler, die während der Ausführung des Vorgangs aufgetreten sind. Das Detailarray enthält die Liste dieser Elemente.
lastModifiedTime	string	Der UTC-Zeitstempel, als der Vorgang begonnen hat.
otherPatchCount	integer	Die Anzahl aller verfügbaren Patches mit Ausnahme kritischer und sicherheitsrelevanter Patches.
rebootPending	boolean	Der allgemeine Neustartstatus der VM. Es trifft zu, wenn teilweise installierte Patches einen Neustart erfordern, um die Installation abzuschließen, aber der Neustart ist noch nicht aufgetreten.
startTime	string	Der UTC-Zeitstempel, als der Vorgang begonnen hat.
status	PatchOperationStatus	Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden.

BillingProfile

Gibt die abrechnungsbezogenen Details eines virtuellen Azure Spot-Computers an. Mindest-API-Version: 2019-03-01.

Name	Typ	Beschreibung
maxPrice	number	Gibt den maximalen Preis an, den Sie für eine Azure Spot-VM/VMSS bezahlen möchten. Dieser Preis liegt in US-Dollar. Dieser Preis wird mit dem aktuellen Azure Spot-Preis für die VM-Größe verglichen. Außerdem werden die Preise zum Zeitpunkt der Erstellung/Aktualisierung von Azure Spot VM/VMSS verglichen, und der Vorgang wird nur erfolgreich ausgeführt, wenn der maxPrice größer als der aktuelle Azure Spot-Preis ist. Der maxPrice wird auch zum Entfernen einer Azure Spot-VM/VMSS verwendet, wenn der aktuelle Azure Spot-Preis nach der Erstellung von VM/VMSS über den maximalen Preis hinausgeht. Mögliche Werte sind: - Ein beliebiger Dezimalwert größer als Null. Beispiel: 0.01538 -1 – Gibt den Standardpreis an, der bei Bedarf up-to werden soll. Sie können den maxPrice auf -1 festlegen, um anzugeben, dass die Azure Spot-VM/VMSS aus Preisgründen nicht entfernt werden sollte. Außerdem wird der standardmäßige Höchstpreis -1, wenn er nicht von Ihnen bereitgestellt wird. Mindest-API-Version: 2019-03-01.

BootDiagnostics

Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. HINWEIS: Wenn "storageUri" angegeben wird, stellen Sie sicher, dass sich das Speicherkonto in derselben Region und im selben Abonnement wie der virtuelle Computer befindet. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.

Name	Typ	Beschreibung
enabled	boolean	Gibt an, ob die Startdiagnose auf dem virtuellen Computer aktiviert werden soll.
storageUri	string	URI des Speicherkontos, das zum Platzieren der Konsolenausgabe und des Screenshots verwendet werden soll. Wenn "storageUri" beim Aktivieren der Startdiagnose nicht angegeben wird, wird verwalteter Speicher verwendet.

BootDiagnosticsInstanceView

Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.

Name	Typ	Beschreibung
consoleScreenshotBlobUri	string	Der Blob-URI des Konsolenfotos. Hinweis: Dies wird nicht festgelegt, wenn die Startdiagnose derzeit mit verwaltetem Speicher aktiviert ist.
serialConsoleLogBlobUri	string	Der BLOB-Uri der seriellen Konsole. Hinweis: Dies wird nicht festgelegt, wenn die Startdiagnose derzeit mit verwaltetem Speicher aktiviert ist.
status	InstanceViewStatus	Die Statusinformationen zur Startdiagnose für den virtuellen Computer. Hinweis: Es wird nur festgelegt, wenn Fehler beim Aktivieren der Startdiagnose aufgetreten sind.

CachingTypes

Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.

Name	Typ	Beschreibung
None	string
ReadOnly	string
ReadWrite	string

CapacityReservationProfile

Gibt Informationen zur Kapazitätsreservierung an, die zum Zuordnen virtueller Computer verwendet wird. Mindest-API-Version: 2021-04-01.

Name	Typ	Beschreibung
capacityReservationGroup	SubResource	Gibt die Ressourcen-ID der Kapazitätsreservierungsgruppe an, die für die Zuordnung des virtuellen Computers oder der Scaleset-VM-Instanzen verwendet werden soll, sofern genügend Kapazität reserviert wurde. Weitere Informationen finden Sie unter https://aka.ms/CapacityReservation.

CloudError

Eine Fehlerantwort des Computediensts.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

ComponentNames

Der Komponentenname. Derzeit ist der einzige zulässige Wert Microsoft-Windows-Shell-Setup.

Name	Typ	Beschreibung
Microsoft-Windows-Shell-Setup	string

DataDisk

Gibt die Parameter an, die zum Hinzufügen eines Datenträgers zu einem virtuellen Computer verwendet werden. Weitere Informationen zu Datenträgern finden Sie unter Informationen zu Datenträgern und VHDs für virtuelle Azure-Computer.

Name	Typ	Beschreibung
caching	CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.
createOption	DiskCreateOptionTypes	Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des Datenträgers für virtuelle Computer verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden. Leer: Dieser Wert wird beim Erstellen eines leeren Datenträgers verwendet. Kopieren: Dieser Wert wird verwendet, um einen Datenträger aus einer Momentaufnahme oder einem anderen Datenträger zu erstellen. Wiederherstellen: Dieser Wert wird verwendet, um einen Datenträger aus einem Datenträgerwiederherstellungspunkt zu erstellen.
deleteOption	DiskDeleteOptionTypes	Gibt an, ob der Datenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Datenträger beim Löschen des virtuellen Computers gelöscht. Abtrennen. Wenn dieser Wert verwendet wird, wird der Datenträger beibehalten, nachdem der virtuelle Computer gelöscht wurde. Der Standardwert ist auf Trennenfestgelegt.
detachOption	DiskDetachOptionTypes	Gibt das Verhalten zum Trennen eines Datenträgers an, das beim Trennen eines Datenträgers verwendet werden soll oder das sich bereits im Prozess der Trennung vom virtuellen Computer befindet. Unterstützte Werte: ForceDetach. detachOption: ForceDetach gilt nur für verwaltete Datenträger. Wenn ein vorheriger Trennungsversuch des Datenträgers aufgrund eines unerwarteten Fehlers vom virtuellen Computer nicht abgeschlossen wurde und der Datenträger noch nicht freigegeben wird, verwenden Sie "Force-detach" als letzte Option zum Trennen des Datenträgers vom virtuellen Computer. Bei Verwendung dieses Trennverhaltens wurden möglicherweise nicht alle Schreibvorgänge geleert. Um das Trennen eines Datenträgerupdates auf "True" zu erzwingen, zusammen mit der Einstellung "tachOption: 'ForceDetach'"
diskIOPSReadWrite	integer	Gibt die Read-Write IOPS für den verwalteten Datenträger an, wenn StorageAccountType UltraSSD_LRS ist. Wird nur für VmMachine ScaleSet-VM-Datenträger zurückgegeben. Kann nur über Updates des VirtualMachine Scale Set aktualisiert werden.
diskMBpsReadWrite	integer	Gibt die Bandbreite pro Sekunde für den verwalteten Datenträger an, wenn StorageAccountType UltraSSD_LRS ist. Wird nur für VmMachine ScaleSet-VM-Datenträger zurückgegeben. Kann nur über Updates des VirtualMachine Scale Set aktualisiert werden.
diskSizeGB	integer	Gibt die Größe eines leeren Datenträgers in Gigabyte an. Dieses Element kann verwendet werden, um die Größe des Datenträgers in einem Image eines virtuellen Computers zu überschreiben. Die Eigenschaft "diskSizeGB" ist die Anzahl der Bytes x 1024^3 für den Datenträger, und der Wert darf nicht größer als 1023 sein.
image	VirtualHardDisk	Die virtuelle Festplatte des Quellbenutzerimages. Die virtuelle Festplatte wird kopiert, bevor sie an den virtuellen Computer angefügt wird. Wenn SourceImage bereitgestellt wird, darf die virtuelle Zielfestplatte nicht vorhanden sein.
lun	integer	Gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden an eine VM angefügten Datenträger eindeutig sein.
managedDisk	ManagedDiskParameters	Die Parameter des verwalteten Datenträgers.
name	string	Der Datenträgername.
sourceResource	ApiEntityReference	Der Quellressourcenbezeichner. Dabei kann es sich um einen Momentaufnahme- oder Datenträgerwiederherstellungspunkt zum Erstellen eines Datenträgers sein.
toBeDetached	boolean	Gibt an, ob der Datenträger von virtualMachine/VirtualMachineScaleset getrennt wird.
vhd	VirtualHardDisk	Die virtuelle Festplatte.
writeAcceleratorEnabled	boolean	Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

DeleteOptions

Angeben, was mit der Netzwerkschnittstelle passiert, wenn der virtuelle Computer gelöscht wird

Name	Typ	Beschreibung
Delete	string
Detach	string

DiagnosticsProfile

Gibt den Status der Startdiagnoseeinstellungen an. Mindest-API-Version: 2015-06-15.

Name	Typ	Beschreibung
bootDiagnostics	BootDiagnostics	Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. HINWEIS: Wenn "storageUri" angegeben wird, stellen Sie sicher, dass sich das Speicherkonto in derselben Region und im selben Abonnement wie der virtuelle Computer befindet. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.

DiffDiskOptions

Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an.

Name	Typ	Beschreibung
Local	string

DiffDiskPlacement

Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Mögliche Werte sind: CacheDisk,ResourceDisk,NvmeDisk. Das Standardverhalten lautet: CacheDisk, wenn eine für die VM-Größe konfiguriert ist, andernfalls ResourceDisk oder NvmeDisk- verwendet wird. In der Vm-Größendokumentation für Windows-VM unter https://docs.microsoft.com/azure/virtual-machines/windows/sizes und Linux-VM unter https://docs.microsoft.com/azure/virtual-machines/linux/sizes können Sie überprüfen, welche VM-Größen einen Cachedatenträger verfügbar machen. Mindest-API-Version für NvmeDisk: 2024-03-01.

Name	Typ	Beschreibung
CacheDisk	string
NvmeDisk	string
ResourceDisk	string

DiffDiskSettings

Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird.

Name	Typ	Beschreibung
option	DiffDiskOptions	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an.
placement	DiffDiskPlacement	Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Mögliche Werte sind: CacheDisk,ResourceDisk,NvmeDisk. Das Standardverhalten lautet: CacheDisk, wenn eine für die VM-Größe konfiguriert ist, andernfalls ResourceDisk oder NvmeDisk- verwendet wird. In der Vm-Größendokumentation für Windows-VM unter https://docs.microsoft.com/azure/virtual-machines/windows/sizes und Linux-VM unter https://docs.microsoft.com/azure/virtual-machines/linux/sizes können Sie überprüfen, welche VM-Größen einen Cachedatenträger verfügbar machen. Mindest-API-Version für NvmeDisk: 2024-03-01.

DiskControllerTypes

Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer konfiguriert ist. Hinweis: Diese Eigenschaft wird auf den Standarddatenträgertyp festgelegt, wenn kein angegebener virtueller Computer mit "hyperVGeneration" auf V2 basierend auf den Funktionen des Betriebssystemdatenträgers und der VM-Größe aus der angegebenen Mindest-API-Version erstellt wird. Sie müssen die Zuordnung des virtuellen Computers vor dem Aktualisieren des Datenträgercontrollertyps durchführen, es sei denn, Sie aktualisieren die VM-Größe in der VM-Konfiguration, die implizit zuordnungen und die VM neu zugeordnet. Mindest-API-Version: 2022-08-01.

Name	Typ	Beschreibung
NVMe	string
SCSI	string

DiskCreateOptionTypes

Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des virtuellen Computers verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden.

Name	Typ	Beschreibung
Attach	string
Copy	string
Empty	string
FromImage	string
Restore	string

DiskDeleteOptionTypes

Gibt an, ob der Betriebssystemdatenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger gelöscht, wenn der virtuelle Computer gelöscht wird. Abtrennen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger nach dem Löschen des virtuellen Computers beibehalten. Der Standardwert ist auf Trennenfestgelegt. Bei einem kurzlebigen Betriebssystemdatenträger wird der Standardwert auf Deletefestgelegt. Der Benutzer kann die Löschoption für einen kurzlebigen Betriebssystemdatenträger nicht ändern.

Name	Typ	Beschreibung
Delete	string
Detach	string

DiskDetachOptionTypes

Gibt das Verhalten zum Trennen eines Datenträgers an, das beim Trennen eines Datenträgers verwendet werden soll oder das sich bereits im Prozess der Trennung vom virtuellen Computer befindet. Unterstützte Werte: ForceDetach. detachOption: ForceDetach gilt nur für verwaltete Datenträger. Wenn ein vorheriger Trennungsversuch des Datenträgers aufgrund eines unerwarteten Fehlers vom virtuellen Computer nicht abgeschlossen wurde und der Datenträger noch nicht freigegeben wird, verwenden Sie "Force-detach" als letzte Option zum Trennen des Datenträgers vom virtuellen Computer. Bei Verwendung dieses Trennverhaltens wurden möglicherweise nicht alle Schreibvorgänge geleert. Um das Trennen eines Datenträgerupdates auf "True" zu erzwingen, zusammen mit der Einstellung "tachOption: 'ForceDetach'"

Name	Typ	Beschreibung
ForceDetach	string

DiskEncryptionSetParameters

Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an.

Name	Typ	Beschreibung
id	string	Ressourcen-ID

DiskEncryptionSettings

Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. Mindest-API-Version: 2015-06-15.

Name	Typ	Beschreibung
diskEncryptionKey	KeyVaultSecretReference	Gibt den Speicherort des Datenträgerverschlüsselungsschlüssels an, bei dem es sich um einen Schlüsseltresorschlüssel handelt.
enabled	boolean	Gibt an, ob die Datenträgerverschlüsselung auf dem virtuellen Computer aktiviert werden soll.
keyEncryptionKey	KeyVaultKeyReference	Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels im Key Vault an.

DiskInstanceView

Die Datenträgerinformationen des virtuellen Computers.

Name	Typ	Beschreibung
encryptionSettings	DiskEncryptionSettings[]	Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. Mindest-API-Version: 2015-06-15
name	string	Der Datenträgername.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.

DomainNameLabelScopeTypes

Der Bereich der Domänenbezeichnung der PublicIPAddress-Ressourcen, die erstellt werden. Die generierte Namensbezeichnung ist die Verkettung der Hash-Domänennamenbezeichnung mit Richtlinie gemäß dem Bereich der Domänenbezeichnung und der eindeutigen ID des vm-Netzwerkprofils.

Name	Typ	Beschreibung
NoReuse	string
ResourceGroupReuse	string
SubscriptionReuse	string
TenantReuse	string

EncryptionIdentity

Gibt die verwaltete Identität an, die von ADE zum Abrufen des Zugriffstokens für Keyvault-Vorgänge verwendet wird.

Name	Typ	Beschreibung
userAssignedIdentityResourceId	string	Gibt die ARM-Ressourcen-ID einer der Benutzeridentitäten an, die der VM zugeordnet sind.

EventGridAndResourceGraph

Die Konfigurationsparameter, die beim Erstellen der Ereigniseinstellung eventGridAndResourceGraph Scheduled Event verwendet werden.

Name	Typ	Beschreibung
enable	boolean	Gibt an, ob Ereignisraster und Ressourcendiagramm für geplante Ereigniskonfigurationen aktiviert sind.

ExtendedLocation

Der erweiterte Speicherort des virtuellen Computers.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.

ExtendedLocationTypes

Der Typ des erweiterten Speicherorts.

Name	Typ	Beschreibung
EdgeZone	string

HardwareProfile

Gibt die Hardwareeinstellungen für den virtuellen Computer an.

Name	Typ	Beschreibung
vmSize	VirtualMachineSizeTypes	Gibt die Größe des virtuellen Computers an. Der Enumerationsdatentyp ist derzeit veraltet und wird bis zum 23. Dezember 2023 entfernt. Die empfohlene Methode zum Abrufen der Liste der verfügbaren Größen ist die Verwendung dieser APIs: Auflisten aller verfügbaren Größe virtueller Computergrößen in einem Verfügbarkeitssatz, Auflisten aller verfügbaren größen virtueller Computer in einer Region, Auflisten aller verfügbaren Größen für virtuelle Computer zum Ändern der Größe. Weitere Informationen zu den Größen virtueller Computer finden Sie unter Größen für virtuelle Computer. Die verfügbaren VM-Größen sind von Region und Verfügbarkeitssatz abhängig.
vmSizeProperties	VMSizeProperties	Gibt die Eigenschaften zum Anpassen der Größe des virtuellen Computers an. Mindest-API-Version: 2021-07-01. Dieses Feature befindet sich weiterhin im Vorschaumodus und wird für VirtualMachineScaleSet nicht unterstützt. Weitere Informationen finden Sie in VM Customization.

HyperVGenerationType

Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist.

Name	Typ	Beschreibung
V1	string
V2	string

ImageReference

Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder virtuellen Computerimages angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein virtuelles Computerimage verwenden möchten, aber nicht in anderen Erstellungsvorgängen verwendet wird.

Name	Typ	Beschreibung
communityGalleryImageId	string	Gibt die eindeutige ID des Communitykatalogimages für die Vm-Bereitstellung an. Dies kann aus dem Community gallery Image GET-Anruf abgerufen werden.
exactVersion	string	Gibt in Dezimalzahlen die Version des Plattformimages oder des Marketplace-Images an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Readonly-Feld unterscheidet sich von "version", nur wenn der im Feld "Version" angegebene Wert "latest" lautet.
id	string	Ressourcen-ID
offer	string	Gibt das Angebot des Plattformimages oder des Marketplace-Images an, das zum Erstellen des virtuellen Computers verwendet wird.
publisher	string	Der Bildherausgeber.
sharedGalleryImageId	string	Gibt die eindeutige ID des freigegebenen Katalogimages für die Vm-Bereitstellung an. Dies kann aus dem GET-Aufruf des freigegebenen Katalogbilds abgerufen werden.
sku	string	Die Bild-SKU.
version	string	Gibt die Version des Plattformimages oder Marketplace-Images an, mit dem der virtuelle Computer erstellt wird. Die zulässigen Formate sind Major.Minor.Build oder "latest". Haupt-, Neben- und Buildwerte sind Dezimalzahlen. Geben Sie "neueste" an, um die neueste Version eines Images zu verwenden, das zur Bereitstellungszeit verfügbar ist. Auch wenn Sie "latest" verwenden, wird das VM-Image nach der Bereitstellung nicht automatisch aktualisiert, auch wenn eine neue Version verfügbar ist. Verwenden Sie das Feld "Version" nicht für die Katalogimagebereitstellung, Galerieimage sollte immer das Feld "ID" für die Bereitstellung verwenden, um die neueste Version des Katalogimages zu verwenden, legen Sie einfach "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}" im Feld "id" ohne Versionseingabe fest.

InnerError

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder das Ausnahmeabbild.
exceptiontype	string	Der Ausnahmetyp.

InstanceViewStatus

Instanzansichtsstatus.

Name	Typ	Beschreibung
code	string	Der Statuscode.
displayStatus	string	Die kurze lokalisierbare Bezeichnung für den Status.
level	StatusLevelTypes	Der Ebenencode.
message	string	Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen.
time	string	Die Uhrzeit des Status.

IPVersions

Ab Api-Version 2019-07-01 ist es verfügbar, ob es sich bei der spezifischen ipconfiguration um IPv4 oder IPv6 handelt. Der Standardwert wird als IPv4 verwendet. Mögliche Werte sind: "IPv4" und "IPv6".

Name	Typ	Beschreibung
IPv4	string
IPv6	string

KeyVaultKeyReference

Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels im Key Vault an.

Name	Typ	Beschreibung
keyUrl	string	Die URL, die auf einen Schlüsselverschlüsselungsschlüssel im Key Vault verweist.
sourceVault	SubResource	Die relative URL des Schlüsseltresors, der den Schlüssel enthält.

KeyVaultSecretReference

Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden

Name	Typ	Beschreibung
secretUrl	string	Die URL, die auf einen geheimen Schlüssel in einem Key Vault verweist.
sourceVault	SubResource	Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält.

LastPatchInstallationSummary

Die Installationszusammenfassung des neuesten Installationsvorgangs für den virtuellen Computer.

Name	Typ	Beschreibung
error	ApiError	Die Fehler, die während der Ausführung des Vorgangs aufgetreten sind. Das Detailarray enthält die Liste dieser Elemente.
excludedPatchCount	integer	Die Anzahl aller verfügbaren Patches, aber explizit von einer vom Kunden angegebenen Ausschlussliste ausgeschlossen.
failedPatchCount	integer	Die Anzahl der Patches, bei denen die Installation fehlgeschlagen ist.
installationActivityId	string	Die Aktivitäts-ID des Vorgangs, der dieses Ergebnis erzeugt hat. Es wird verwendet, um in CRP- und Erweiterungsprotokollen zu korrelieren.
installedPatchCount	integer	Die Anzahl der Patches, die erfolgreich installiert wurden.
lastModifiedTime	string	Der UTC-Zeitstempel, als der Vorgang begonnen hat.
maintenanceWindowExceeded	boolean	Beschreibt, ob der Vorgang nicht mehr genügend Zeit hat, bevor er alle beabsichtigten Aktionen abgeschlossen hat.
notSelectedPatchCount	integer	Die Anzahl aller verfügbaren Patches, aber nicht installiert werden, da sie nicht mit einem Eintrag für Klassifizierungen oder Einschlusslisten übereinstimmte.
pendingPatchCount	integer	Die Anzahl aller verfügbaren Patches, die im Verlauf des Patchinstallationsvorgangs installiert werden sollen.
startTime	string	Der UTC-Zeitstempel, als der Vorgang begonnen hat.
status	PatchOperationStatus	Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden.

LinuxConfiguration

Gibt die Linux-Betriebssystemeinstellungen auf dem virtuellen Computer an. Eine Liste der unterstützten Linux-Distributionen finden Sie unter Linux unter Azure-Endorsed Distributionen.

Name	Typ	Beschreibung
disablePasswordAuthentication	boolean	Gibt an, ob die Kennwortauthentifizierung deaktiviert werden soll.
enableVMAgentPlatformUpdates	boolean	Gibt an, ob VMAgent Platform Updates für den virtuellen Linux-Computer aktiviert ist. Der Standardwert ist "false".
patchSettings	LinuxPatchSettings	[Vorschaufeature] Gibt Einstellungen im Zusammenhang mit VM-Gastpatching unter Linux an.
provisionVMAgent	boolean	Gibt an, ob der Agent des virtuellen Computers auf dem virtuellen Computer bereitgestellt werden soll. Wenn diese Eigenschaft nicht im Anforderungstext angegeben ist, wird sie standardmäßig auf "true" festgelegt. Dadurch wird sichergestellt, dass der VM-Agent auf dem virtuellen Computer installiert ist, damit Erweiterungen später zur VM hinzugefügt werden können.
ssh	SshConfiguration	Gibt die Ssh-Schlüsselkonfiguration für ein Linux-Betriebssystem an.

LinuxPatchAssessmentMode

Gibt den Modus der VM-Gastpatchbewertung für den virtuellen IaaS-Computer an.

Mögliche Werte sind:

ImageDefault- – Sie steuern den Zeitpunkt der Patchbewertungen auf einem virtuellen Computer.

AutomaticByPlatform – Die Plattform löst regelmäßige Patchbewertungen aus. Die Eigenschaft provisionVMAgent muss true sein.

Name	Typ	Beschreibung
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

[Vorschaufeature] Gibt Einstellungen im Zusammenhang mit VM-Gastpatching unter Linux an.

Name	Typ	Beschreibung
assessmentMode	LinuxPatchAssessmentMode	Gibt den Modus der VM-Gastpatchbewertung für den virtuellen IaaS-Computer an. Mögliche Werte sind: ImageDefault- – Sie steuern den Zeitpunkt der Patchbewertungen auf einem virtuellen Computer. AutomaticByPlatform – Die Plattform löst regelmäßige Patchbewertungen aus. Die Eigenschaft provisionVMAgent muss true sein.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Gibt zusätzliche Einstellungen für den Patchmodus AutomaticByPlatform in VM-Gastpatching unter Linux an.
patchMode	LinuxVMGuestPatchMode	Gibt den Modus des VM-Gastpatchings auf iaaS-VM-Computer oder virtuelle Computer an, die mit orchestrationMode als flexibel verknüpft sind. Mögliche Werte sind: ImageDefault- – Die Standardpatchingkonfiguration des virtuellen Computers wird verwendet. AutomaticByPlatform – Der virtuelle Computer wird automatisch von der Plattform aktualisiert. Die Eigenschaft provisionVMAgent muss true sein.

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Gibt die Neustarteinstellung für alle AutomaticByPlatform-Patchinstallationsvorgänge an.

Name	Typ	Beschreibung
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Gibt zusätzliche Einstellungen für den Patchmodus AutomaticByPlatform in VM-Gastpatching unter Linux an.

Name	Typ	Beschreibung
bypassPlatformSafetyChecksOnUserSchedule	boolean	Ermöglicht es Kunden, Patching ohne versehentliche Upgrades zu planen
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Gibt die Neustarteinstellung für alle AutomaticByPlatform-Patchinstallationsvorgänge an.

LinuxVMGuestPatchMode

Gibt den Modus des VM-Gastpatchings auf iaaS-VM-Computer oder virtuelle Computer an, die mit orchestrationMode als flexibel verknüpft sind.

Mögliche Werte sind:

ImageDefault- – Die Standardpatchingkonfiguration des virtuellen Computers wird verwendet.

AutomaticByPlatform – Der virtuelle Computer wird automatisch von der Plattform aktualisiert. Die Eigenschaft provisionVMAgent muss true sein.

Name	Typ	Beschreibung
AutomaticByPlatform	string
ImageDefault	string

MaintenanceOperationResultCodeTypes

Der letzte Ergebniscode des Wartungsvorgangs.

Name	Typ	Beschreibung
MaintenanceAborted	string
MaintenanceCompleted	string
None	string
RetryLater	string

MaintenanceRedeployStatus

Der Wartungsvorgangsstatus auf dem virtuellen Computer.

Name	Typ	Beschreibung
isCustomerInitiatedMaintenanceAllowed	boolean	True, wenn der Kunde Wartungsvorgänge durchführen darf.
lastOperationMessage	string	Die Nachricht, die für den letzten Wartungsvorgang zurückgegeben wurde.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	Der letzte Ergebniscode des Wartungsvorgangs.
maintenanceWindowEndTime	string	Endzeit für das Wartungsfenster.
maintenanceWindowStartTime	string	Startzeit für das Wartungsfenster.
preMaintenanceWindowEndTime	string	Endzeit für das Fenster vor der Wartung.
preMaintenanceWindowStartTime	string	Startzeit für das Fenster vor der Wartung.

ManagedDiskParameters

Die Parameter des verwalteten Datenträgers.

Name	Typ	Beschreibung
diskEncryptionSet	DiskEncryptionSetParameters	Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an.
id	string	Ressourcen-ID
securityProfile	VMDiskSecurityProfile	Gibt das Sicherheitsprofil für den verwalteten Datenträger an.
storageAccountType	StorageAccountTypes	Gibt den Speicherkontotyp für den verwalteten Datenträger an. HINWEIS: UltraSSD_LRS nur mit Datenträgern verwendet werden kann, kann sie nicht mit Betriebssystemdatenträgern verwendet werden.

Mode

Gibt den Modus an, für den ProxyAgent ausgeführt wird, wenn das Feature aktiviert ist. ProxyAgent beginnt mit der Überwachung oder Überwachung, erzwingt jedoch keine Zugriffssteuerung für Anforderungen an Hostendpunkte im Überwachungsmodus, während im Erzwingungsmodus die Zugriffssteuerung erzwungen wird. Der Standardwert ist der Erzwingungsmodus.

Name	Typ	Beschreibung
Audit	string
Enforce	string

NetworkApiVersion

Gibt die Microsoft.Network-API-Version an, die beim Erstellen von Netzwerkressourcen in den Netzwerkschnittstellenkonfigurationen verwendet wird.

Name	Typ	Beschreibung
2020-11-01	string

NetworkInterfaceAuxiliaryMode

Gibt an, ob der Hilfsmodus für die Netzwerkschnittstellenressource aktiviert ist.

Name	Typ	Beschreibung
AcceleratedConnections	string
Floating	string
None	string

NetworkInterfaceAuxiliarySku

Gibt an, ob die Hilfssku für die Netzwerkschnittstellenressource aktiviert ist.

Name	Typ	Beschreibung
A1	string
A2	string
A4	string
A8	string
None	string

NetworkInterfaceReference

Gibt die Liste der Ressourcen-IDs für die Netzwerkschnittstellen an, die dem virtuellen Computer zugeordnet sind.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
properties.deleteOption	DeleteOptions	Angeben, was mit der Netzwerkschnittstelle passiert, wenn der virtuelle Computer gelöscht wird
properties.primary	boolean	Gibt die primäre Netzwerkschnittstelle an, falls der virtuelle Computer über mehr als 1 Netzwerkschnittstelle verfügt.

NetworkProfile

Gibt die Netzwerkschnittstellen des virtuellen Computers an.

Name	Typ	Beschreibung
networkApiVersion	NetworkApiVersion	Gibt die Microsoft.Network-API-Version an, die beim Erstellen von Netzwerkressourcen in den Netzwerkschnittstellenkonfigurationen verwendet wird.
networkInterfaceConfigurations	VirtualMachineNetworkInterfaceConfiguration[]	Gibt die Netzwerkkonfigurationen an, die zum Erstellen der Netzwerkressourcen für virtuelle Computer verwendet werden.
networkInterfaces	NetworkInterfaceReference[]	Gibt die Liste der Ressourcen-IDs für die Netzwerkschnittstellen an, die dem virtuellen Computer zugeordnet sind.

OperatingSystemTypes

Der Betriebssystemtyp.

Name	Typ	Beschreibung
Linux	string
Windows	string

OSDisk

Gibt Informationen zum Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. Weitere Informationen zu Datenträgern finden Sie unter Informationen zu Datenträgern und VHDs für virtuelle Azure-Computer.

Name	Typ	Beschreibung
caching	CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.
createOption	DiskCreateOptionTypes	Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des virtuellen Computers verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden.
deleteOption	DiskDeleteOptionTypes	Gibt an, ob der Betriebssystemdatenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger gelöscht, wenn der virtuelle Computer gelöscht wird. Abtrennen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger nach dem Löschen des virtuellen Computers beibehalten. Der Standardwert ist auf Trennenfestgelegt. Bei einem kurzlebigen Betriebssystemdatenträger wird der Standardwert auf Deletefestgelegt. Der Benutzer kann die Löschoption für einen kurzlebigen Betriebssystemdatenträger nicht ändern.
diffDiskSettings	DiffDiskSettings	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird.
diskSizeGB	integer	Gibt die Größe eines leeren Datenträgers in Gigabyte an. Dieses Element kann verwendet werden, um die Größe des Datenträgers in einem Image eines virtuellen Computers zu überschreiben. Die Eigenschaft "diskSizeGB" ist die Anzahl der Bytes x 1024^3 für den Datenträger, und der Wert darf nicht größer als 1023 sein.
encryptionSettings	DiskEncryptionSettings	Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. Mindest-API-Version: 2015-06-15.
image	VirtualHardDisk	Die virtuelle Festplatte des Quellbenutzerimages. Die virtuelle Festplatte wird kopiert, bevor sie an den virtuellen Computer angefügt wird. Wenn SourceImage bereitgestellt wird, darf die virtuelle Zielfestplatte nicht vorhanden sein.
managedDisk	ManagedDiskParameters	Die Parameter des verwalteten Datenträgers.
name	string	Der Datenträgername.
osType	OperatingSystemTypes	Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn ein virtueller Computer über ein Benutzerimage oder eine spezielle VHD erstellt wird. Mögliche Werte sind: Windows,Linux.
vhd	VirtualHardDisk	Die virtuelle Festplatte.
writeAcceleratorEnabled	boolean	Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

OSImageNotificationProfile

Gibt konfigurationen im Zusammenhang mit dem geplanten Betriebssystemimage an.

Name	Typ	Beschreibung
enable	boolean	Gibt an, ob das geplante Betriebssystemimageereignis aktiviert oder deaktiviert ist.
notBeforeTimeout	string	Zeitdauer, die ein virtueller Computer neu abbildet oder das Betriebssystemupgrade aktualisiert wird, muss das geplante Betriebssystemimageereignis möglicherweise genehmigen, bevor das Ereignis automatisch genehmigt wird (Timeout). Die Konfiguration wird im ISO 8601-Format angegeben, und der Wert muss 15 Minuten (PT15M) sein.

OSProfile

Gibt die Betriebssystemeinstellungen an, die beim Erstellen des virtuellen Computers verwendet werden. Einige der Einstellungen können nicht geändert werden, nachdem der virtuelle Computer bereitgestellt wurde.

Name	Typ	Beschreibung
adminPassword	string	Gibt das Kennwort des Administratorkontos an. Mindestlänge (Windows): 8 Zeichen Mindestlänge (Linux): 6 Zeichen Max. Länge (Windows): 123 Zeichen Max-Length (Linux): 72 Zeichen Komplexitätsanforderungen: 3 von 4 unten aufgeführten Bedingungen müssen erfüllt sein Enthält Zeichen mit niedrigeren Zeichen Enthält groß geschriebene Zeichen Hat eine Ziffer Weist ein Sonderzeichen auf (Regex-Übereinstimmung [\W_]) Unzulässige Werte: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" Informationen zum Zurücksetzen des Kennworts finden Sie unter Zurücksetzen des Remotedesktopdiensts oder seines Anmeldekennworts in einer Windows-VM- Informationen zum Zurücksetzen des Stammkennworts finden Sie unter Verwalten von Benutzern, SSH und Überprüfen oder Reparieren von Datenträgern auf Azure Linux-VMs mithilfe der VMAccess-Erweiterung
adminUsername	string	Gibt den Namen des Administratorkontos an. Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Nur-Windows-Einschränkung: Kann nicht in "" enden. Unzulässige Werte: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". Mindestlänge (Linux): 1 Zeichen Max-Length (Linux): 64 Zeichen Max. Länge (Windows): 20 Zeichen.
allowExtensionOperations	boolean	Gibt an, ob Erweiterungsvorgänge auf dem virtuellen Computer zulässig sein sollen. Dies kann nur auf False festgelegt werden, wenn keine Erweiterungen auf dem virtuellen Computer vorhanden sind.
computerName	string	Gibt den Hostnamen des virtuellen Computers an. Dieser Name kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Max. Länge (Windows): 15 Zeichen. Max-Length (Linux): 64 Zeichen. Benennungskonventionen und Einschränkungen finden Sie in Implementierungsrichtlinien für Azure-Infrastrukturdienste.
customData	string	Gibt eine base64-codierte Zeichenfolge von benutzerdefinierten Daten an. Die base64-codierte Zeichenfolge wird mit einem binären Array decodiert, das als Datei auf dem virtuellen Computer gespeichert wird. Die maximale Länge des binären Arrays beträgt 65535 Bytes. Hinweis: Übergeben Sie keine geheimen Schlüssel oder Kennwörter in der customData-Eigenschaft. Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Die Eigenschaft "customData" wird an den virtuellen Computer übergeben, der als Datei gespeichert werden soll. Weitere Informationen finden Sie unter Benutzerdefinierte Daten auf Azure-VMs. Informationen zur Verwendung von Cloud-Init für Ihre Linux-VM finden Sie unter Verwenden von Cloud-Init zum Anpassen einer Linux-VM während der Erstellung.
linuxConfiguration	LinuxConfiguration	Gibt die Linux-Betriebssystemeinstellungen auf dem virtuellen Computer an. Eine Liste der unterstützten Linux-Distributionen finden Sie unter Linux unter Azure-Endorsed Distributionen.
requireGuestProvisionSignal	boolean	Optionale Eigenschaft, die entweder auf True festgelegt oder weggelassen werden muss.
secrets	VaultSecretGroup[]	Gibt einen Satz von Zertifikaten an, die auf dem virtuellen Computer installiert werden sollen. Um Zertifikate auf einem virtuellen Computer zu installieren, empfiehlt es sich, die erweiterung des virtuellen Azure Key Vault-Computers für Linux oder die erweiterung des virtuellen Azure Key Vault-Computers für Windowszu verwenden.
windowsConfiguration	WindowsConfiguration	Gibt die Windows-Betriebssystemeinstellungen auf dem virtuellen Computer an.

PassNames

Der Passname. Derzeit ist der einzige zulässige Wert OobeSystem.

Name	Typ	Beschreibung
OobeSystem	string

PatchOperationStatus

Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden.

Name	Typ	Beschreibung
CompletedWithWarnings	string
Failed	string
InProgress	string
Succeeded	string
Unknown	string

PatchSettings

[Vorschaufeature] Gibt Einstellungen im Zusammenhang mit VM-Gastpatching unter Windows an.

Name	Typ	Beschreibung
assessmentMode	WindowsPatchAssessmentMode	Gibt den Modus der VM-Gastpatchbewertung für den virtuellen IaaS-Computer an. Mögliche Werte sind: ImageDefault- – Sie steuern den Zeitpunkt der Patchbewertungen auf einem virtuellen Computer. AutomaticByPlatform – Die Plattform löst regelmäßige Patchbewertungen aus. Die Eigenschaft provisionVMAgent muss true sein.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Gibt zusätzliche Einstellungen für den Patchmodus AutomaticByPlatform in VM-Gastpatching unter Windows an.
enableHotpatching	boolean	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.
patchMode	WindowsVMGuestPatchMode	Gibt den Modus des VM-Gastpatchings auf iaaS-VM-Computer oder virtuelle Computer an, die mit orchestrationMode als flexibel verknüpft sind. Mögliche Werte sind: Manuelle – Sie steuern die Anwendung von Patches auf einen virtuellen Computer. Dazu wenden Sie Patches manuell innerhalb des virtuellen Computers an. In diesem Modus sind automatische Updates deaktiviert; die Eigenschaft "WindowsConfiguration.enableAutomaticUpdates" muss "false" sein. AutomaticByOS- – Der virtuelle Computer wird automatisch vom Betriebssystem aktualisiert. Die Eigenschaft "WindowsConfiguration.enableAutomaticUpdates" muss "true" sein. AutomaticByPlatform – der virtuelle Computer wird automatisch von der Plattform aktualisiert. Die Eigenschaften provisionVMAgent und WindowsConfiguration.enableAutomaticUpdates müssen true sein.

Plan

Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Bilder verwendet. Bevor Sie ein Marketplace-Image aus einer API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal das Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Möchten Sie programmgesteuert bereitstellen, Erste Schritte –>. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.

Name	Typ	Beschreibung
name	string	Die Plan-ID.
product	string	Gibt das Produkt des Bilds vom Marketplace an. Dies ist derselbe Wert wie Offer unter dem imageReference-Element.
promotionCode	string	Der Heraufsufungscode.
publisher	string	Die Herausgeber-ID.

ProtocolTypes

Gibt das Protokoll des WinRM-Listeners an. Mögliche Werte sind: http,https.

Name	Typ	Beschreibung
Http	string
Https	string

ProxyAgentSettings

Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an. Mindest-API-Version: 2023-09-01.

Name	Typ	Beschreibung
enabled	boolean	Gibt an, ob das ProxyAgent-Feature auf dem virtuellen Computer oder im Skalierungssatz des virtuellen Computers aktiviert werden soll.
keyIncarnationId	integer	Wenn Sie den Wert dieser Eigenschaft erhöhen, können Benutzer den Schlüssel zurücksetzen, der zum Sichern des Kommunikationskanals zwischen Gast und Host verwendet wird.
mode	Mode	Gibt den Modus an, für den ProxyAgent ausgeführt wird, wenn das Feature aktiviert ist. ProxyAgent beginnt mit der Überwachung oder Überwachung, erzwingt jedoch keine Zugriffssteuerung für Anforderungen an Hostendpunkte im Überwachungsmodus, während im Erzwingungsmodus die Zugriffssteuerung erzwungen wird. Der Standardwert ist der Erzwingungsmodus.

PublicIPAddressSku

Beschreibt die öffentliche IP-Sku. Er kann nur mit OrchestrationMode als flexibel festgelegt werden.

Name	Typ	Beschreibung
name	PublicIPAddressSkuName	Angeben des öffentlichen IP-Sku-Namens
tier	PublicIPAddressSkuTier	Angeben der öffentlichen IP-Sku-Ebene

PublicIPAddressSkuName

Angeben des öffentlichen IP-Sku-Namens

Name	Typ	Beschreibung
Basic	string
Standard	string

PublicIPAddressSkuTier

Angeben der öffentlichen IP-Sku-Ebene

Name	Typ	Beschreibung
Global	string
Regional	string

PublicIPAllocationMethod

Angeben des öffentlichen IP-Zuordnungstyps

Name	Typ	Beschreibung
Dynamic	string
Static	string

ResourceIdentityType

Der Identitätstyp, der für den virtuellen Computer verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

Name	Typ	Beschreibung
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

ScheduledEventsAdditionalPublishingTargets

Die Konfigurationsparameter, die beim Veröffentlichen von scheduledEventsAdditionalPublishingTargets verwendet werden.

Name	Typ	Beschreibung
eventGridAndResourceGraph	EventGridAndResourceGraph	Die Konfigurationsparameter, die beim Erstellen der Ereigniseinstellung eventGridAndResourceGraph Scheduled Event verwendet werden.

ScheduledEventsPolicy

Gibt redeploy, Reboot und ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations for the virtual machine an.

Name	Typ	Beschreibung
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Die Konfigurationsparameter, die beim Veröffentlichen von scheduledEventsAdditionalPublishingTargets verwendet werden.
userInitiatedReboot	UserInitiatedReboot	Die Konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedReboot"-Ereigniseinstellung verwendet werden.
userInitiatedRedeploy	UserInitiatedRedeploy	Die konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedRedeploy scheduled event setting creation" verwendet werden.

ScheduledEventsProfile

Gibt geplante Ereigniskonfigurationen an.

Name	Typ	Beschreibung
osImageNotificationProfile	OSImageNotificationProfile	Gibt konfigurationen im Zusammenhang mit dem geplanten Betriebssystemimage an.
terminateNotificationProfile	TerminateNotificationProfile	Gibt terminbezogene Terminkonfigurationen an.

securityEncryptionTypes

Gibt den EncryptionType des verwalteten Datenträgers an. Es ist für die Verschlüsselung des verwalteten Datenträgers auf DiskWithVMGuestStateState festgelegt, vmGuestStateOnly für die Verschlüsselung nur des VMGuestState-Blobs und NonPersistedTPM, um den Firmwarestatus im VMGuestState-Blob nicht beizubehalten. Hinweis: Sie kann nur für vertrauliche virtuelle Computer festgelegt werden.

Name	Typ	Beschreibung
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

Gibt die Sicherheitsbezogenen Profileinstellungen für den virtuellen Computer an.

Name	Typ	Beschreibung
encryptionAtHost	boolean	Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. Das Standardverhalten lautet: Die Verschlüsselung auf dem Host wird deaktiviert, es sei denn, diese Eigenschaft ist für die Ressource auf "true" festgelegt.
encryptionIdentity	EncryptionIdentity	Gibt die verwaltete Identität an, die von ADE zum Abrufen des Zugriffstokens für Keyvault-Vorgänge verwendet wird.
proxyAgentSettings	ProxyAgentSettings	Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an. Mindest-API-Version: 2023-09-01.
securityType	SecurityTypes	Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. Das Standardverhalten lautet: UefiSettings wird nur aktiviert, wenn diese Eigenschaft festgelegt ist.
uefiSettings	UefiSettings	Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. Mindest-API-Version: 2020-12-01.

SecurityTypes

Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. Das Standardverhalten lautet: UefiSettings wird nur aktiviert, wenn diese Eigenschaft festgelegt ist.

Name	Typ	Beschreibung
ConfidentialVM	string
TrustedLaunch	string

SettingNames

Gibt den Namen der Einstellung an, auf die der Inhalt angewendet wird. Mögliche Werte sind: FirstLogonCommands und AutoLogon.

Name	Typ	Beschreibung
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

Gibt die Ssh-Schlüsselkonfiguration für ein Linux-Betriebssystem an.

Name	Typ	Beschreibung
publicKeys	SshPublicKey[]	Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit linuxbasierten VMs verwendet werden.

SshPublicKey

Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit linuxbasierten VMs verwendet werden.

Name	Typ	Beschreibung
keyData	string	SSH-Zertifikat für öffentliche Schlüssel, das für die Authentifizierung mit dem virtuellen Computer über ssh verwendet wird. Der Schlüssel muss mindestens 2048-Bit und im ssh-rsa-Format sein. Informationen zum Erstellen von SSH-Schlüsseln finden Sie unter [Erstellen von SSH-Schlüsseln unter Linux und Mac für Linux-VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Gibt den vollständigen Pfad auf der erstellten VM an, auf der ssh-öffentlicher Schlüssel gespeichert ist. Wenn die Datei bereits vorhanden ist, wird der angegebene Schlüssel an die Datei angefügt. Beispiel: /home/user/.ssh/authorized_keys

StatusLevelTypes

Der Ebenencode.

Name	Typ	Beschreibung
Error	string
Info	string
Warning	string

StorageAccountTypes

Gibt den Speicherkontotyp für den verwalteten Datenträger an. HINWEIS: UltraSSD_LRS nur mit Datenträgern verwendet werden kann, kann sie nicht mit Betriebssystemdatenträgern verwendet werden.

Name	Typ	Beschreibung
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

StorageProfile

Gibt die Speichereinstellungen für die Datenträger des virtuellen Computers an.

Name	Typ	Beschreibung
dataDisks	DataDisk[]	Gibt die Parameter an, die zum Hinzufügen eines Datenträgers zu einem virtuellen Computer verwendet werden. Weitere Informationen zu Datenträgern finden Sie unter Informationen zu Datenträgern und VHDs für virtuelle Azure-Computer.
diskControllerType	DiskControllerTypes	Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer konfiguriert ist. Hinweis: Diese Eigenschaft wird auf den Standarddatenträgertyp festgelegt, wenn kein angegebener virtueller Computer mit "hyperVGeneration" auf V2 basierend auf den Funktionen des Betriebssystemdatenträgers und der VM-Größe aus der angegebenen Mindest-API-Version erstellt wird. Sie müssen die Zuordnung des virtuellen Computers vor dem Aktualisieren des Datenträgercontrollertyps durchführen, es sei denn, Sie aktualisieren die VM-Größe in der VM-Konfiguration, die implizit zuordnungen und die VM neu zugeordnet. Mindest-API-Version: 2022-08-01.
imageReference	ImageReference	Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder virtuellen Computerimages angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein virtuelles Computerimage verwenden möchten, aber nicht in anderen Erstellungsvorgängen verwendet wird.
osDisk	OSDisk	Gibt Informationen zum Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. Weitere Informationen zu Datenträgern finden Sie unter Informationen zu Datenträgern und VHDs für virtuelle Azure-Computer.

SubResource

Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält.

Name	Typ	Beschreibung
id	string	Ressourcen-ID

TerminateNotificationProfile

Gibt terminbezogene Terminkonfigurationen an.

Name	Typ	Beschreibung
enable	boolean	Gibt an, ob das Terminplanereignis aktiviert oder deaktiviert ist.
notBeforeTimeout	string	Konfigurierbare Zeitspanne, die ein virtueller Computer gelöscht wird, muss das terminierte Ereignis potenziell genehmigen, bevor das Ereignis automatisch genehmigt wird (Timeout). Die Konfiguration muss im ISO 8601-Format angegeben werden, der Standardwert beträgt 5 Minuten (PT5M)

UefiSettings

Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. Mindest-API-Version: 2020-12-01.

Name	Typ	Beschreibung
secureBootEnabled	boolean	Gibt an, ob der sichere Start auf dem virtuellen Computer aktiviert werden soll. Mindest-API-Version: 2020-12-01.
vTpmEnabled	boolean	Gibt an, ob vTPM auf dem virtuellen Computer aktiviert werden soll. Mindest-API-Version: 2020-12-01.

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die dem virtuellen Computer zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name	Typ	Beschreibung

UserInitiatedReboot

Die Konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedReboot"-Ereigniseinstellung verwendet werden.

Name	Typ	Beschreibung
automaticallyApprove	boolean	Gibt konfigurationen im Zusammenhang mit dem Geplanten Neustartereignis an.

UserInitiatedRedeploy

Die konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedRedeploy scheduled event setting creation" verwendet werden.

Name	Typ	Beschreibung
automaticallyApprove	boolean	Gibt die konfigurationen für geplante Ereignisse neu bereitstellen an.

VaultCertificate

Die Liste der Schlüsseltresorverweise in SourceVault, die Zertifikate enthalten.

Name	Typ	Beschreibung
certificateStore	string	Gibt für Windows-VMs den Zertifikatspeicher auf dem virtuellen Computer an, dem das Zertifikat hinzugefügt werden soll. Der angegebene Zertifikatspeicher befindet sich implizit im LocalMachine-Konto. Für Linux-VMs wird die Zertifikatdatei unter dem Verzeichnis "/var/lib/waagent" platziert, wobei der Dateiname <"UppercaseThumbprint">.crt für die X509-Zertifikatdatei und <"UppercaseThumbprint">.prv für privaten Schlüssel. Beide Dateien sind PEM formatiert.
certificateUrl	string	Dies ist die URL eines Zertifikats, das als geheimer Schlüssel in den Key Vault hochgeladen wurde. Informationen zum Hinzufügen eines Geheimschlüssels zum Schlüsseltresor finden Sie unter Hinzufügen eines Schlüssels oder geheimen Schlüssels zum Schlüsseltresor. In diesem Fall muss Ihr Zertifikat die Base64-Codierung des folgenden JSON-Objekts sein, das in UTF-8 codiert ist: { "data":", "dataType":"pfx", "password":"" } Um Zertifikate auf einem virtuellen Computer zu installieren, empfiehlt es sich, die erweiterung des virtuellen Azure Key Vault-Computers für Linux oder die erweiterung des virtuellen Azure Key Vault-Computers für Windowszu verwenden.

VaultSecretGroup

Gibt einen Satz von Zertifikaten an, die auf dem virtuellen Computer installiert werden sollen. Um Zertifikate auf einem virtuellen Computer zu installieren, empfiehlt es sich, die erweiterung des virtuellen Azure Key Vault-Computers für Linux oder die erweiterung des virtuellen Azure Key Vault-Computers für Windowszu verwenden.

Name	Typ	Beschreibung
sourceVault	SubResource	Die relative URL des Key Vault mit allen Zertifikaten in VaultCertificates.
vaultCertificates	VaultCertificate[]	Die Liste der Schlüsseltresorverweise in SourceVault, die Zertifikate enthalten.

VirtualHardDisk

Die virtuelle Festplatte.

Name	Typ	Beschreibung
uri	string	Gibt den URI der virtuellen Festplatte an.

VirtualMachine

Beschreibt einen virtuellen Computer.

Name	Typ	Beschreibung
etag	string	Etag wird in der Antwort "Create/Update/Get" der VM zurückgegeben, sodass der Kunde es im Header bereitstellen kann, um optimistische Updates sicherzustellen.
extendedLocation	ExtendedLocation	Der erweiterte Speicherort des virtuellen Computers.
id	string	Ressourcen-ID
identity	VirtualMachineIdentity	Die Identität des virtuellen Computers, falls konfiguriert.
location	string	Ressourcenspeicherort
managedBy	string	ManagedBy ist auf vm Scale Set(VMSS) flex ARM resourceID festgelegt, wenn der virtuelle Computer Teil des VMSS ist. Diese Eigenschaft wird von der Plattform für die Optimierung der internen Ressourcengruppenlöschung verwendet.
name	string	Ressourcenname
plan	Plan	Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Bilder verwendet. Bevor Sie ein Marketplace-Image aus einer API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal das Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Möchten Sie programmgesteuert bereitstellen, Erste Schritte –>. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.
properties.additionalCapabilities	AdditionalCapabilities	Gibt zusätzliche Funktionen an, die auf dem virtuellen Computer aktiviert oder deaktiviert sind.
properties.applicationProfile	ApplicationProfile	Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.
properties.availabilitySet	SubResource	Gibt Informationen zum Verfügbarkeitssatz an, dem der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die im gleichen Verfügbarkeitssatz angegeben sind, werden verschiedenen Knoten zugewiesen, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitssätzen finden Sie unter Übersicht über Verfügbarkeitssätze. Weitere Informationen zur geplanten Wartung von Azure finden Sie unter Wartung und Updates für virtuelle Computer in Azure. Derzeit kann eine VM nur zur Erstellungszeit zur Verfügbarkeit hinzugefügt werden. Der Verfügbarkeitssatz, zu dem der virtuelle Computer hinzugefügt wird, sollte sich unter derselben Ressourcengruppe wie die Verfügbarkeitssatzressource befinden. Eine vorhandene VM kann keinem Verfügbarkeitssatz hinzugefügt werden. Diese Eigenschaft kann nicht zusammen mit einer Nicht-Null-Eigenschaft.virtualMachineScaleSet-Referenz vorhanden sein.
properties.billingProfile	BillingProfile	Gibt die abrechnungsbezogenen Details eines virtuellen Azure Spot-Computers an. Mindest-API-Version: 2019-03-01.
properties.capacityReservation	CapacityReservationProfile	Gibt Informationen zur Kapazitätsreservierung an, die zum Zuordnen virtueller Computer verwendet wird. Mindest-API-Version: 2021-04-01.
properties.diagnosticsProfile	DiagnosticsProfile	Gibt den Status der Startdiagnoseeinstellungen an. Mindest-API-Version: 2015-06-15.
properties.evictionPolicy	VirtualMachineEvictionPolicyTypes	Gibt die Eviction-Richtlinie für den virtuellen Azure Spot-Computer und den Azure Spot-Skalierungssatz an. Für virtuelle Azure Spot-Computer werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2019-03-01. Bei Azure Spot-Skalierungssätzen werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2017-10-30-preview.
properties.extensionsTimeBudget	string	Gibt die Uhrzeit an, die für alle zu startenden Erweiterungen zugewiesen wurde. Die Zeitdauer sollte zwischen 15 Minuten und 120 Minuten (einschließlich) liegen und im ISO 8601-Format angegeben werden. Der Standardwert ist 90 Minuten (PT1H30M). Mindest-API-Version: 2020-06-01.
properties.hardwareProfile	HardwareProfile	Gibt die Hardwareeinstellungen für den virtuellen Computer an.
properties.host	SubResource	Gibt Informationen zum dedizierten Host an, in dem sich der virtuelle Computer befindet. Mindest-API-Version: 2018-10-01.
properties.hostGroup	SubResource	Gibt Informationen zur dedizierten Hostgruppe an, in der sich der virtuelle Computer befindet. Hinweis: Benutzer können sowohl host- als auch hostGroup-Eigenschaften nicht angeben. Mindest-API-Version: 2020-06-01.
properties.instanceView	VirtualMachineInstanceView	Die Instanzansicht des virtuellen Computers.
properties.licenseType	string	Gibt an, dass das verwendete Image oder der verwendete Datenträger lokal lizenziert wurde. Mögliche Werte für das Windows Server-Betriebssystem sind: Windows_Client Windows_Server Mögliche Werte für das Linux Server-Betriebssystem sind: RHEL_BYOS (für RHEL) SLES_BYOS (für SUSE) Weitere Informationen finden Sie unter Azure Hybrid Use Benefit for Windows Server Azure Hybrid Use Benefit für Linux Server Mindest-API-Version: 2015-06-15
properties.networkProfile	NetworkProfile	Gibt die Netzwerkschnittstellen des virtuellen Computers an.
properties.osProfile	OSProfile	Gibt die Betriebssystemeinstellungen an, die beim Erstellen des virtuellen Computers verwendet werden. Einige der Einstellungen können nicht geändert werden, nachdem der virtuelle Computer bereitgestellt wurde.
properties.platformFaultDomain	integer	Gibt die logische Fehlerdomäne des Skalierungssatzes an, in der der virtuelle Computer erstellt wird. Standardmäßig wird der virtuelle Computer automatisch einer Fehlerdomäne zugewiesen, die das Gleichgewicht zwischen den verfügbaren Fehlerdomänen am besten gewährleistet. Dies gilt nur, wenn die Eigenschaft "virtualMachineScaleSet" dieses virtuellen Computers festgelegt ist. Auf den Skalierungssatz für virtuelle Computer, auf den verwiesen wird, muss "platformFaultDomainCount" größer als 1 sein. Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Fehlerdomänenzuweisung kann in der Instanzansicht des virtuellen Computers angezeigt werden. Mindest-API-Version: 2020-12‐01.
properties.priority	VirtualMachinePriorityTypes	Gibt die Priorität für den virtuellen Computer an. Mindest-API-Version: 2019-03-01
properties.provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
properties.proximityPlacementGroup	SubResource	Gibt Informationen zur Näherungsplatzierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. Mindest-API-Version: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Gibt redeploy, Reboot und ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations for the virtual machine an.
properties.scheduledEventsProfile	ScheduledEventsProfile	Gibt geplante Ereigniskonfigurationen an.
properties.securityProfile	SecurityProfile	Gibt die Sicherheitsbezogenen Profileinstellungen für den virtuellen Computer an.
properties.storageProfile	StorageProfile	Gibt die Speichereinstellungen für die Datenträger des virtuellen Computers an.
properties.timeCreated	string	Gibt den Zeitpunkt an, zu dem die Ressource des virtuellen Computers erstellt wurde. Mindest-API-Version: 2021-11-01.
properties.userData	string	UserData für den virtuellen Computer, der base64-codiert sein muss. Der Kunde sollte hier keine Geheimnisse weitergeben. Mindest-API-Version: 2021-03-01.
properties.virtualMachineScaleSet	SubResource	Gibt Informationen zum Skalierungssatz des virtuellen Computers an, dem der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die im gleichen Skalierungssatz für virtuelle Computer angegeben sind, werden verschiedenen Knoten zugewiesen, um die Verfügbarkeit zu maximieren. Derzeit kann eine VM nur zur Erstellungszeit für vm-Skalierungssätze hinzugefügt werden. Eine vorhandene VM kann keinem Skalierungssatz für virtuelle Computer hinzugefügt werden. Diese Eigenschaft kann nicht zusammen mit einer Nicht-Null-Eigenschaft.availabilitySet-Referenz vorhanden sein. Mindest-API-Version: 2019‐03‐01.
properties.vmId	string	Gibt die eindeutige ID des virtuellen Computers an, bei der es sich um einen 128-Bit-Bezeichner handelt, der in allen Azure IaaS-VMs SMBIOS codiert und gespeichert ist und mithilfe von Plattform-BIOS-Befehlen gelesen werden kann.
resources	VirtualMachineExtension[]	Die Ressourcen für die untergeordnete Erweiterung des virtuellen Computers.
tags	object	Ressourcentags
type	string	Ressourcentyp
zones	string[]	Die Zonen des virtuellen Computers.

VirtualMachineAgentInstanceView

Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird.

Name	Typ	Beschreibung
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	Die Instanzansicht der Erweiterungshandler für virtuelle Computer.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
vmAgentVersion	string	Die Vollversion des VM-Agents.

VirtualMachineEvictionPolicyTypes

Gibt die Eviction-Richtlinie für den virtuellen Azure Spot-Computer und den Azure Spot-Skalierungssatz an. Für virtuelle Azure Spot-Computer werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2019-03-01. Bei Azure Spot-Skalierungssätzen werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2017-10-30-preview.

Name	Typ	Beschreibung
Deallocate	string
Delete	string

VirtualMachineExtension

Die Ressourcen für die untergeordnete Erweiterung des virtuellen Computers.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
location	string	Ressourcenspeicherort
name	string	Ressourcenname
properties.autoUpgradeMinorVersion	boolean	Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist.
properties.enableAutomaticUpgrade	boolean	Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist.
properties.forceUpdateTag	string	Wie der Erweiterungshandler aktualisiert werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.
properties.instanceView	VirtualMachineExtensionInstanceView	Die Erweiterungsinstanzansicht des virtuellen Computers.
properties.protectedSettings	object	Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.
properties.protectedSettingsFromKeyVault	KeyVaultSecretReference	Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden
properties.provisionAfterExtensions	string[]	Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss.
properties.provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
properties.publisher	string	Der Name des Herausgebers des Erweiterungshandlers.
properties.settings	object	Json formatierte öffentliche Einstellungen für die Erweiterung.
properties.suppressFailures	boolean	Gibt an, ob Fehler, die aus der Erweiterung stammen, unterdrückt werden (Betriebsfehler, z. B. keine Verbindung mit dem virtuellen Computer, werden unabhängig von diesem Wert nicht unterdrückt). Der Standardwert ist "false".
properties.type	string	Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".
properties.typeHandlerVersion	string	Gibt die Version des Skripthandlers an.
tags	object	Ressourcentags
type	string	Ressourcentyp

VirtualMachineExtensionHandlerInstanceView

Die Instanzansicht der Erweiterungshandler für virtuelle Computer.

Name	Typ	Beschreibung
status	InstanceViewStatus	Der Erweiterungshandlerstatus.
type	string	Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".
typeHandlerVersion	string	Gibt die Version des Skripthandlers an.

VirtualMachineExtensionInstanceView

Die Erweiterungsinstanzansicht des virtuellen Computers.

Name	Typ	Beschreibung
name	string	Der Erweiterungsname des virtuellen Computers.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
substatuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
type	string	Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".
typeHandlerVersion	string	Gibt die Version des Skripthandlers an.

VirtualMachineHealthStatus

Der Integritätsstatus für den virtuellen Computer.

Name	Typ	Beschreibung
status	InstanceViewStatus	Die Integritätsstatusinformationen für den virtuellen Computer.

VirtualMachineIdentity

Die Identität des virtuellen Computers, falls konfiguriert.

Name	Typ	Beschreibung
principalId	string	Die Prinzipal-ID der Identität virtueller Computer. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
tenantId	string	Die Mandanten-ID, die dem virtuellen Computer zugeordnet ist. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
type	ResourceIdentityType	Der Identitätstyp, der für den virtuellen Computer verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.
userAssignedIdentities	UserAssignedIdentities	Die Liste der Benutzeridentitäten, die dem virtuellen Computer zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

VirtualMachineInstanceView

Die Instanzansicht des virtuellen Computers.

Name	Typ	Beschreibung
assignedHost	string	Ressourcen-ID des dedizierten Hosts, auf dem der virtuelle Computer über die automatische Platzierung zugewiesen wird, wenn der virtuelle Computer einer dedizierten Hostgruppe zugeordnet ist, für die die automatische Platzierung aktiviert ist. Mindest-API-Version: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.
computerName	string	Der Computername, der dem virtuellen Computer zugewiesen ist.
disks	DiskInstanceView[]	Die Datenträgerinformationen des virtuellen Computers.
extensions	VirtualMachineExtensionInstanceView[]	Die Erweiterungsinformationen.
hyperVGeneration	HyperVGenerationType	Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist.
isVMInStandbyPool	boolean	[Vorschaufeature] Gibt an, ob sich der virtuelle Computer derzeit im Standbypool befindet oder nicht.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Der Wartungsvorgangsstatus auf dem virtuellen Computer.
osName	string	Das Betriebssystem, das auf dem virtuellen Computer ausgeführt wird.
osVersion	string	Die Version des Betriebssystems, das auf dem virtuellen Computer ausgeführt wird.
patchStatus	VirtualMachinePatchStatus	[Vorschaufeature] Der Status von Patchvorgängen für virtuelle Computer.
platformFaultDomain	integer	Gibt die Fehlerdomäne des virtuellen Computers an.
platformUpdateDomain	integer	Gibt die Updatedomäne des virtuellen Computers an.
rdpThumbPrint	string	Fingerabdruck des Remotedesktopzertifikats.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
vmAgent	VirtualMachineAgentInstanceView	Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird.
vmHealth	VirtualMachineHealthStatus	Der Integritätsstatus für den virtuellen Computer.

VirtualMachineIpTag

Die Liste der IP-Tags, die der öffentlichen IP-Adresse zugeordnet sind.

Name	Typ	Beschreibung
ipTagType	string	IP-Tagtyp. Beispiel: FirstPartyUsage.
tag	string	IP-Tag, das der öffentlichen IP zugeordnet ist. Beispiel: SQL, Speicher usw.

VirtualMachineNetworkInterfaceConfiguration

Gibt die Netzwerkkonfigurationen an, die zum Erstellen der Netzwerkressourcen für virtuelle Computer verwendet werden.

Name	Typ	Beschreibung
name	string	Der Konfigurationsname der Netzwerkschnittstelle.
properties.auxiliaryMode	NetworkInterfaceAuxiliaryMode	Gibt an, ob der Hilfsmodus für die Netzwerkschnittstellenressource aktiviert ist.
properties.auxiliarySku	NetworkInterfaceAuxiliarySku	Gibt an, ob die Hilfssku für die Netzwerkschnittstellenressource aktiviert ist.
properties.deleteOption	DeleteOptions	Angeben, was mit der Netzwerkschnittstelle passiert, wenn der virtuelle Computer gelöscht wird
properties.disableTcpStateTracking	boolean	Gibt an, ob die Netzwerkschnittstelle für die Tcp-Zustandsnachverfolgung deaktiviert ist.
properties.dnsSettings	VirtualMachineNetworkInterfaceDnsSettingsConfiguration	Die DNS-Einstellungen, die auf die Netzwerkschnittstellen angewendet werden sollen.
properties.dscpConfiguration	SubResource
properties.enableAcceleratedNetworking	boolean	Gibt an, ob die Netzwerkschnittstelle durch netzwerkbeschleunigte Netzwerke beschleunigt wird.
properties.enableFpga	boolean	Gibt an, ob es sich bei der Netzwerkschnittstelle um EINE FPGA-Netzwerk-fähige Netzwerkschnittstelle handelt.
properties.enableIPForwarding	boolean	Gibt an, ob die IP-Weiterleitung für diese NIC aktiviert ist.
properties.ipConfigurations	VirtualMachineNetworkInterfaceIPConfiguration[]	Gibt die IP-Konfigurationen der Netzwerkschnittstelle an.
properties.networkSecurityGroup	SubResource	Die Netzwerksicherheitsgruppe.
properties.primary	boolean	Gibt die primäre Netzwerkschnittstelle an, falls der virtuelle Computer über mehr als 1 Netzwerkschnittstelle verfügt.

VirtualMachineNetworkInterfaceDnsSettingsConfiguration

Die DNS-Einstellungen, die auf die Netzwerkschnittstellen angewendet werden sollen.

Name	Typ	Beschreibung
dnsServers	string[]	Liste der DNS-Server-IP-Adressen

VirtualMachineNetworkInterfaceIPConfiguration

Gibt die IP-Konfigurationen der Netzwerkschnittstelle an.

Name	Typ	Beschreibung
name	string	Der NAME der IP-Konfiguration.
properties.applicationGatewayBackendAddressPools	SubResource[]	Gibt ein Array von Verweisen auf Back-End-Adresspools von Anwendungsgateways an. Ein virtueller Computer kann auf Back-End-Adresspools mehrerer Anwendungsgateways verweisen. Mehrere virtuelle Computer können nicht dasselbe Anwendungsgateway verwenden.
properties.applicationSecurityGroups	SubResource[]	Gibt ein Array von Verweisen auf die Anwendungssicherheitsgruppe an.
properties.loadBalancerBackendAddressPools	SubResource[]	Gibt ein Array von Verweisen auf Back-End-Adresspools von Lastenausgleichsmodulen an. Ein virtueller Computer kann auf Back-End-Adresspools eines öffentlichen und eines internen Lastenausgleichs verweisen. [Mehrere virtuelle Computer können nicht den gleichen grundlegenden SKU-Lastenausgleich verwenden].
properties.primary	boolean	Gibt die primäre Netzwerkschnittstelle an, falls der virtuelle Computer über mehr als 1 Netzwerkschnittstelle verfügt.
properties.privateIPAddressVersion	IPVersions	Verfügbar ab Api-Version 2017-03-30, gibt es an, ob es sich bei der spezifischen ipconfiguration um IPv4 oder IPv6 handelt. Der Standardwert wird als IPv4 verwendet. Mögliche Werte sind: "IPv4" und "IPv6".
properties.publicIPAddressConfiguration	VirtualMachinePublicIPAddressConfiguration	Die publicIPAddressConfiguration.
properties.subnet	SubResource	Gibt den Bezeichner des Subnetzes an.

VirtualMachinePatchStatus

[Vorschaufeature] Der Status von Patchvorgängen für virtuelle Computer.

Name	Typ	Beschreibung
availablePatchSummary	AvailablePatchSummary	Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer.
configurationStatuses	InstanceViewStatus[]	Der Aktivierungsstatus des angegebenen patchMode
lastPatchInstallationSummary	LastPatchInstallationSummary	Die Installationszusammenfassung des neuesten Installationsvorgangs für den virtuellen Computer.

VirtualMachinePriorityTypes

Gibt die Priorität für den virtuellen Computer an. Mindest-API-Version: 2019-03-01

Name	Typ	Beschreibung
Low	string
Regular	string
Spot	string

VirtualMachinePublicIPAddressConfiguration

Die publicIPAddressConfiguration.

Name	Typ	Beschreibung
name	string	Der Name der PublicIP-Adresskonfiguration.
properties.deleteOption	DeleteOptions	Angeben, was mit der öffentlichen IP-Adresse passiert, wenn der virtuelle Computer gelöscht wird
properties.dnsSettings	VirtualMachinePublicIPAddressDnsSettingsConfiguration	Die dns-Einstellungen, die auf die publicIP-Adressen angewendet werden sollen.
properties.idleTimeoutInMinutes	integer	Das Leerlauftimeout der öffentlichen IP-Adresse.
properties.ipTags	VirtualMachineIpTag[]	Die Liste der IP-Tags, die der öffentlichen IP-Adresse zugeordnet sind.
properties.publicIPAddressVersion	IPVersions	Ab Api-Version 2019-07-01 ist es verfügbar, ob es sich bei der spezifischen ipconfiguration um IPv4 oder IPv6 handelt. Der Standardwert wird als IPv4 verwendet. Mögliche Werte sind: "IPv4" und "IPv6".
properties.publicIPAllocationMethod	PublicIPAllocationMethod	Angeben des öffentlichen IP-Zuordnungstyps
properties.publicIPPrefix	SubResource	Das PublicIPPrefix, aus dem publicIP-Adressen zugeordnet werden sollen.
sku	PublicIPAddressSku	Beschreibt die öffentliche IP-Sku. Er kann nur mit OrchestrationMode als flexibel festgelegt werden.

VirtualMachinePublicIPAddressDnsSettingsConfiguration

Die dns-Einstellungen, die auf die publicIP-Adressen angewendet werden sollen.

Name	Typ	Beschreibung
domainNameLabel	string	Das Präfix "Domain name label" der publicIPAddress-Ressourcen, die erstellt werden. Die generierte Namensbezeichnung ist die Verkettung der Domänennamenbezeichnung und der eindeutigen ID des vm-Netzwerkprofils.
domainNameLabelScope	DomainNameLabelScopeTypes	Der Bereich der Domänenbezeichnung der PublicIPAddress-Ressourcen, die erstellt werden. Die generierte Namensbezeichnung ist die Verkettung der Hash-Domänennamenbezeichnung mit Richtlinie gemäß dem Bereich der Domänenbezeichnung und der eindeutigen ID des vm-Netzwerkprofils.

VirtualMachineSizeTypes

Gibt die Größe des virtuellen Computers an. Der Enumerationsdatentyp ist derzeit veraltet und wird bis zum 23. Dezember 2023 entfernt. Die empfohlene Methode zum Abrufen der Liste der verfügbaren Größen ist die Verwendung dieser APIs: Auflisten aller verfügbaren Größe virtueller Computergrößen in einem Verfügbarkeitssatz, Auflisten aller verfügbaren größen virtueller Computer in einer Region, Auflisten aller verfügbaren Größen für virtuelle Computer zum Ändern der Größe. Weitere Informationen zu den Größen virtueller Computer finden Sie unter Größen für virtuelle Computer. Die verfügbaren VM-Größen sind von Region und Verfügbarkeitssatz abhängig.

Name	Typ	Beschreibung
Basic_A0	string
Basic_A1	string
Basic_A2	string
Basic_A3	string
Basic_A4	string
Standard_A0	string
Standard_A1	string
Standard_A10	string
Standard_A11	string
Standard_A1_v2	string
Standard_A2	string
Standard_A2_v2	string
Standard_A2m_v2	string
Standard_A3	string
Standard_A4	string
Standard_A4_v2	string
Standard_A4m_v2	string
Standard_A5	string
Standard_A6	string
Standard_A7	string
Standard_A8	string
Standard_A8_v2	string
Standard_A8m_v2	string
Standard_A9	string
Standard_B1ms	string
Standard_B1s	string
Standard_B2ms	string
Standard_B2s	string
Standard_B4ms	string
Standard_B8ms	string
Standard_D1	string
Standard_D11	string
Standard_D11_v2	string
Standard_D12	string
Standard_D12_v2	string
Standard_D13	string
Standard_D13_v2	string
Standard_D14	string
Standard_D14_v2	string
Standard_D15_v2	string
Standard_D16_v3	string
Standard_D16s_v3	string
Standard_D1_v2	string
Standard_D2	string
Standard_D2_v2	string
Standard_D2_v3	string
Standard_D2s_v3	string
Standard_D3	string
Standard_D32_v3	string
Standard_D32s_v3	string
Standard_D3_v2	string
Standard_D4	string
Standard_D4_v2	string
Standard_D4_v3	string
Standard_D4s_v3	string
Standard_D5_v2	string
Standard_D64_v3	string
Standard_D64s_v3	string
Standard_D8_v3	string
Standard_D8s_v3	string
Standard_DS1	string
Standard_DS11	string
Standard_DS11_v2	string
Standard_DS12	string
Standard_DS12_v2	string
Standard_DS13	string
Standard_DS13-2_v2	string
Standard_DS13-4_v2	string
Standard_DS13_v2	string
Standard_DS14	string
Standard_DS14-4_v2	string
Standard_DS14-8_v2	string
Standard_DS14_v2	string
Standard_DS15_v2	string
Standard_DS1_v2	string
Standard_DS2	string
Standard_DS2_v2	string
Standard_DS3	string
Standard_DS3_v2	string
Standard_DS4	string
Standard_DS4_v2	string
Standard_DS5_v2	string
Standard_E16_v3	string
Standard_E16s_v3	string
Standard_E2_v3	string
Standard_E2s_v3	string
Standard_E32-16_v3	string
Standard_E32-8s_v3	string
Standard_E32_v3	string
Standard_E32s_v3	string
Standard_E4_v3	string
Standard_E4s_v3	string
Standard_E64-16s_v3	string
Standard_E64-32s_v3	string
Standard_E64_v3	string
Standard_E64s_v3	string
Standard_E8_v3	string
Standard_E8s_v3	string
Standard_F1	string
Standard_F16	string
Standard_F16s	string
Standard_F16s_v2	string
Standard_F1s	string
Standard_F2	string
Standard_F2s	string
Standard_F2s_v2	string
Standard_F32s_v2	string
Standard_F4	string
Standard_F4s	string
Standard_F4s_v2	string
Standard_F64s_v2	string
Standard_F72s_v2	string
Standard_F8	string
Standard_F8s	string
Standard_F8s_v2	string
Standard_G1	string
Standard_G2	string
Standard_G3	string
Standard_G4	string
Standard_G5	string
Standard_GS1	string
Standard_GS2	string
Standard_GS3	string
Standard_GS4	string
Standard_GS4-4	string
Standard_GS4-8	string
Standard_GS5	string
Standard_GS5-16	string
Standard_GS5-8	string
Standard_H16	string
Standard_H16m	string
Standard_H16mr	string
Standard_H16r	string
Standard_H8	string
Standard_H8m	string
Standard_L16s	string
Standard_L32s	string
Standard_L4s	string
Standard_L8s	string
Standard_M128-32ms	string
Standard_M128-64ms	string
Standard_M128ms	string
Standard_M128s	string
Standard_M64-16ms	string
Standard_M64-32ms	string
Standard_M64ms	string
Standard_M64s	string
Standard_NC12	string
Standard_NC12s_v2	string
Standard_NC12s_v3	string
Standard_NC24	string
Standard_NC24r	string
Standard_NC24rs_v2	string
Standard_NC24rs_v3	string
Standard_NC24s_v2	string
Standard_NC24s_v3	string
Standard_NC6	string
Standard_NC6s_v2	string
Standard_NC6s_v3	string
Standard_ND12s	string
Standard_ND24rs	string
Standard_ND24s	string
Standard_ND6s	string
Standard_NV12	string
Standard_NV24	string
Standard_NV6	string

VirtualMachineUpdate

Parameter, die für den Update Virtual Machine-Vorgang bereitgestellt werden.

Name	Typ	Beschreibung
identity	VirtualMachineIdentity	Die Identität des virtuellen Computers, falls konfiguriert.
plan	Plan	Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Bilder verwendet. Bevor Sie ein Marketplace-Image aus einer API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal das Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Möchten Sie programmgesteuert bereitstellen, Erste Schritte –>. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.
properties.additionalCapabilities	AdditionalCapabilities	Gibt zusätzliche Funktionen an, die auf dem virtuellen Computer aktiviert oder deaktiviert sind.
properties.applicationProfile	ApplicationProfile	Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.
properties.availabilitySet	SubResource	Gibt Informationen zum Verfügbarkeitssatz an, dem der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die im gleichen Verfügbarkeitssatz angegeben sind, werden verschiedenen Knoten zugewiesen, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitssätzen finden Sie unter Übersicht über Verfügbarkeitssätze. Weitere Informationen zur geplanten Wartung von Azure finden Sie unter Wartung und Updates für virtuelle Computer in Azure. Derzeit kann eine VM nur zur Erstellungszeit zur Verfügbarkeit hinzugefügt werden. Der Verfügbarkeitssatz, zu dem der virtuelle Computer hinzugefügt wird, sollte sich unter derselben Ressourcengruppe wie die Verfügbarkeitssatzressource befinden. Eine vorhandene VM kann keinem Verfügbarkeitssatz hinzugefügt werden. Diese Eigenschaft kann nicht zusammen mit einer Nicht-Null-Eigenschaft.virtualMachineScaleSet-Referenz vorhanden sein.
properties.billingProfile	BillingProfile	Gibt die abrechnungsbezogenen Details eines virtuellen Azure Spot-Computers an. Mindest-API-Version: 2019-03-01.
properties.capacityReservation	CapacityReservationProfile	Gibt Informationen zur Kapazitätsreservierung an, die zum Zuordnen virtueller Computer verwendet wird. Mindest-API-Version: 2021-04-01.
properties.diagnosticsProfile	DiagnosticsProfile	Gibt den Status der Startdiagnoseeinstellungen an. Mindest-API-Version: 2015-06-15.
properties.evictionPolicy	VirtualMachineEvictionPolicyTypes	Gibt die Eviction-Richtlinie für den virtuellen Azure Spot-Computer und den Azure Spot-Skalierungssatz an. Für virtuelle Azure Spot-Computer werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2019-03-01. Bei Azure Spot-Skalierungssätzen werden sowohl "Deallocate" als auch "Delete" unterstützt, und die mindeste API-Version ist 2017-10-30-preview.
properties.extensionsTimeBudget	string	Gibt die Uhrzeit an, die für alle zu startenden Erweiterungen zugewiesen wurde. Die Zeitdauer sollte zwischen 15 Minuten und 120 Minuten (einschließlich) liegen und im ISO 8601-Format angegeben werden. Der Standardwert ist 90 Minuten (PT1H30M). Mindest-API-Version: 2020-06-01.
properties.hardwareProfile	HardwareProfile	Gibt die Hardwareeinstellungen für den virtuellen Computer an.
properties.host	SubResource	Gibt Informationen zum dedizierten Host an, in dem sich der virtuelle Computer befindet. Mindest-API-Version: 2018-10-01.
properties.hostGroup	SubResource	Gibt Informationen zur dedizierten Hostgruppe an, in der sich der virtuelle Computer befindet. Hinweis: Benutzer können sowohl host- als auch hostGroup-Eigenschaften nicht angeben. Mindest-API-Version: 2020-06-01.
properties.instanceView	VirtualMachineInstanceView	Die Instanzansicht des virtuellen Computers.
properties.licenseType	string	Gibt an, dass das verwendete Image oder der verwendete Datenträger lokal lizenziert wurde. Mögliche Werte für das Windows Server-Betriebssystem sind: Windows_Client Windows_Server Mögliche Werte für das Linux Server-Betriebssystem sind: RHEL_BYOS (für RHEL) SLES_BYOS (für SUSE) Weitere Informationen finden Sie unter Azure Hybrid Use Benefit for Windows Server Azure Hybrid Use Benefit für Linux Server Mindest-API-Version: 2015-06-15
properties.networkProfile	NetworkProfile	Gibt die Netzwerkschnittstellen des virtuellen Computers an.
properties.osProfile	OSProfile	Gibt die Betriebssystemeinstellungen an, die beim Erstellen des virtuellen Computers verwendet werden. Einige der Einstellungen können nicht geändert werden, nachdem der virtuelle Computer bereitgestellt wurde.
properties.platformFaultDomain	integer	Gibt die logische Fehlerdomäne des Skalierungssatzes an, in der der virtuelle Computer erstellt wird. Standardmäßig wird der virtuelle Computer automatisch einer Fehlerdomäne zugewiesen, die das Gleichgewicht zwischen den verfügbaren Fehlerdomänen am besten gewährleistet. Dies gilt nur, wenn die Eigenschaft "virtualMachineScaleSet" dieses virtuellen Computers festgelegt ist. Auf den Skalierungssatz für virtuelle Computer, auf den verwiesen wird, muss "platformFaultDomainCount" größer als 1 sein. Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Fehlerdomänenzuweisung kann in der Instanzansicht des virtuellen Computers angezeigt werden. Mindest-API-Version: 2020-12‐01.
properties.priority	VirtualMachinePriorityTypes	Gibt die Priorität für den virtuellen Computer an. Mindest-API-Version: 2019-03-01
properties.provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
properties.proximityPlacementGroup	SubResource	Gibt Informationen zur Näherungsplatzierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. Mindest-API-Version: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Gibt redeploy, Reboot und ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations for the virtual machine an.
properties.scheduledEventsProfile	ScheduledEventsProfile	Gibt geplante Ereigniskonfigurationen an.
properties.securityProfile	SecurityProfile	Gibt die Sicherheitsbezogenen Profileinstellungen für den virtuellen Computer an.
properties.storageProfile	StorageProfile	Gibt die Speichereinstellungen für die Datenträger des virtuellen Computers an.
properties.timeCreated	string	Gibt den Zeitpunkt an, zu dem die Ressource des virtuellen Computers erstellt wurde. Mindest-API-Version: 2021-11-01.
properties.userData	string	UserData für den virtuellen Computer, der base64-codiert sein muss. Der Kunde sollte hier keine Geheimnisse weitergeben. Mindest-API-Version: 2021-03-01.
properties.virtualMachineScaleSet	SubResource	Gibt Informationen zum Skalierungssatz des virtuellen Computers an, dem der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die im gleichen Skalierungssatz für virtuelle Computer angegeben sind, werden verschiedenen Knoten zugewiesen, um die Verfügbarkeit zu maximieren. Derzeit kann eine VM nur zur Erstellungszeit für vm-Skalierungssätze hinzugefügt werden. Eine vorhandene VM kann keinem Skalierungssatz für virtuelle Computer hinzugefügt werden. Diese Eigenschaft kann nicht zusammen mit einer Nicht-Null-Eigenschaft.availabilitySet-Referenz vorhanden sein. Mindest-API-Version: 2019‐03‐01.
properties.vmId	string	Gibt die eindeutige ID des virtuellen Computers an, bei der es sich um einen 128-Bit-Bezeichner handelt, der in allen Azure IaaS-VMs SMBIOS codiert und gespeichert ist und mithilfe von Plattform-BIOS-Befehlen gelesen werden kann.
tags	object	Ressourcentags
zones	string[]	Die Zonen des virtuellen Computers.

VMDiskSecurityProfile

Gibt das Sicherheitsprofil für den verwalteten Datenträger an.

Name	Typ	Beschreibung
diskEncryptionSet	DiskEncryptionSetParameters	Gibt die Vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an, der für den vom Kunden verwalteten Schlüssel verschlüsselter VertraulichVM-Betriebssystemdatenträger und vmGuest-Blob verwendet wird.
securityEncryptionType	securityEncryptionTypes	Gibt den EncryptionType des verwalteten Datenträgers an. Es ist für die Verschlüsselung des verwalteten Datenträgers auf DiskWithVMGuestStateState festgelegt, vmGuestStateOnly für die Verschlüsselung nur des VMGuestState-Blobs und NonPersistedTPM, um den Firmwarestatus im VMGuestState-Blob nicht beizubehalten. Hinweis: Sie kann nur für vertrauliche virtuelle Computer festgelegt werden.

VMGalleryApplication

Gibt die Kataloganwendungen an, die dem virtuellen Computer/VMSS zur Verfügung gestellt werden sollen.

Name	Typ	Beschreibung
configurationReference	string	Optional, gibt den URI für ein Azure-Blob an, der die Standardkonfiguration für das Paket ersetzt, falls angegeben.
enableAutomaticUpgrade	boolean	Wenn dieser Wert auf "true" festgelegt ist, wenn eine neue Galerieanwendungsversion in PIR/SIG verfügbar ist, wird sie automatisch für die VM/VMSS aktualisiert.
order	integer	Optional, gibt die Reihenfolge an, in der die Pakete installiert werden müssen.
packageReferenceId	string	Gibt die GalleryApplicationVersion-Ressourcen-ID in Form von /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version} an.
tags	string	Optional, Specifies a passthrough value for more generic context.
treatFailureAsDeploymentFailure	boolean	Optional, Wenn wahr, tritt bei einem Fehler für einen Vorgang in der VmApplication die Bereitstellung fehl.

VMSizeProperties

Gibt die Eigenschaften zum Anpassen der Größe des virtuellen Computers an. Mindest-API-Version: 2021-07-01. Dieses Feature befindet sich weiterhin im Vorschaumodus und wird für VirtualMachineScaleSet nicht unterstützt. Weitere Informationen finden Sie in VM Customization.

Name	Typ	Beschreibung
vCPUsAvailable	integer	Gibt die Anzahl der für den virtuellen Computer verfügbaren vCPUs an. Wenn diese Eigenschaft nicht im Anforderungstext angegeben ist, ist das Standardverhalten, es auf den Wert von vCPUs festzulegen, der für diese VM-Größe verfügbar ist, die in api-Antwort von Auflisten aller verfügbaren virtuellen Computergrößen in einer Region.
vCPUsPerCore	integer	Gibt das vCPU-Verhältnis zum physischen Kernverhältnis an. Wenn diese Eigenschaft nicht im Anforderungstext angegeben ist, wird das Standardverhalten auf den Wert von vCPUsPerCore für die VM-Größe festgelegt, die in api-Antwort von Auflisten aller verfügbaren virtuellen Computergrößen in einer Region. Festlegen dieser Eigenschaft auf 1 bedeutet auch, dass Hyperthreading deaktiviert ist.

WindowsConfiguration

Gibt die Windows-Betriebssystemeinstellungen auf dem virtuellen Computer an.

Name	Typ	Beschreibung
additionalUnattendContent	AdditionalUnattendContent[]	Gibt zusätzliche base64-codierte XML-formatierte Informationen an, die in der Unattend.xml-Datei enthalten sein können, die von Windows Setup verwendet wird.
enableAutomaticUpdates	boolean	Gibt an, ob automatische Updates für den virtuellen Windows-Computer aktiviert sind. Der Standardwert ist true. Bei Skalierungssätzen für virtuelle Computer kann diese Eigenschaft aktualisiert werden, und Updates wirken sich auf die Erneute Bereitstellung des Betriebssystems aus.
enableVMAgentPlatformUpdates	boolean	Gibt an, ob VMAgent-Plattformupdates für den virtuellen Windows-Computer aktiviert sind.
patchSettings	PatchSettings	[Vorschaufeature] Gibt Einstellungen im Zusammenhang mit VM-Gastpatching unter Windows an.
provisionVMAgent	boolean	Gibt an, ob der Agent des virtuellen Computers auf dem virtuellen Computer bereitgestellt werden soll. Wenn diese Eigenschaft nicht im Anforderungstext angegeben ist, wird sie standardmäßig auf "true" festgelegt. Dadurch wird sichergestellt, dass der VM-Agent auf dem virtuellen Computer installiert ist, damit Erweiterungen später zur VM hinzugefügt werden können.
timeZone	string	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.GetSystemTimeZoneszurückgegeben werden.
winRM	WinRMConfiguration	Gibt die Windows-Remoteverwaltungslistener an. Dies ermöglicht Remote-Windows PowerShell.

WindowsPatchAssessmentMode

Gibt den Modus der VM-Gastpatchbewertung für den virtuellen IaaS-Computer an.

Mögliche Werte sind:

ImageDefault- – Sie steuern den Zeitpunkt der Patchbewertungen auf einem virtuellen Computer.

AutomaticByPlatform – Die Plattform löst regelmäßige Patchbewertungen aus. Die Eigenschaft provisionVMAgent muss true sein.

Name	Typ	Beschreibung
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Gibt die Neustarteinstellung für alle AutomaticByPlatform-Patchinstallationsvorgänge an.

Name	Typ	Beschreibung
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Gibt zusätzliche Einstellungen für den Patchmodus AutomaticByPlatform in VM-Gastpatching unter Windows an.

Name	Typ	Beschreibung
bypassPlatformSafetyChecksOnUserSchedule	boolean	Ermöglicht es Kunden, Patching ohne versehentliche Upgrades zu planen
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Gibt die Neustarteinstellung für alle AutomaticByPlatform-Patchinstallationsvorgänge an.

WindowsVMGuestPatchMode

Gibt den Modus des VM-Gastpatchings auf iaaS-VM-Computer oder virtuelle Computer an, die mit orchestrationMode als flexibel verknüpft sind.

Mögliche Werte sind:

Manuelle – Sie steuern die Anwendung von Patches auf einen virtuellen Computer. Dazu wenden Sie Patches manuell innerhalb des virtuellen Computers an. In diesem Modus sind automatische Updates deaktiviert; die Eigenschaft "WindowsConfiguration.enableAutomaticUpdates" muss "false" sein.

AutomaticByOS- – Der virtuelle Computer wird automatisch vom Betriebssystem aktualisiert. Die Eigenschaft "WindowsConfiguration.enableAutomaticUpdates" muss "true" sein.

AutomaticByPlatform – der virtuelle Computer wird automatisch von der Plattform aktualisiert. Die Eigenschaften provisionVMAgent und WindowsConfiguration.enableAutomaticUpdates müssen true sein.

Name	Typ	Beschreibung
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

Gibt die Windows-Remoteverwaltungslistener an. Dies ermöglicht Remote-Windows PowerShell.

Name	Typ	Beschreibung
listeners	WinRMListener[]	Die Liste der Windows-Remoteverwaltungslistener

WinRMListener

Die Liste der Windows-Remoteverwaltungslistener

Name	Typ	Beschreibung
certificateUrl	string	Dies ist die URL eines Zertifikats, das als geheimer Schlüssel in den Key Vault hochgeladen wurde. Informationen zum Hinzufügen eines Geheimschlüssels zum Schlüsseltresor finden Sie unter Hinzufügen eines Schlüssels oder geheimen Schlüssels zum Schlüsseltresor. In diesem Fall muss Ihr Zertifikat die Base64-Codierung des folgenden JSON-Objekts sein, das in UTF-8 codiert ist: { "data":", "dataType":"pfx", "password":"" } Um Zertifikate auf einem virtuellen Computer zu installieren, empfiehlt es sich, die erweiterung des virtuellen Azure Key Vault-Computers für Linux oder die erweiterung des virtuellen Azure Key Vault-Computers für Windowszu verwenden.
protocol	ProtocolTypes	Gibt das Protokoll des WinRM-Listeners an. Mögliche Werte sind: http,https.