Virtual Machines - Update

Servizio:

Compute

Versione API:

2024-07-01

Operazione per aggiornare una macchina virtuale.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
vmName	path	True	string	Nome della macchina virtuale.
api-version	query	True	string	Versione dell'API client.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag della trasformazione. Omettere questo valore per sovrascrivere sempre la risorsa corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.
If-None-Match		string	Impostare su '*' per consentire la creazione di un nuovo set di record, ma per impedire l'aggiornamento di un set di record esistente. Gli altri valori genereranno errori dal server perché non sono supportati.

Corpo della richiesta

Nome	Tipo	Descrizione
parameters	VirtualMachineUpdate	Parametri forniti all'operazione Aggiorna macchina virtuale.

Risposte

Nome	Tipo	Descrizione
200 OK	VirtualMachine	OK
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Update a VM by detaching data disk

Update a VM by force-detaching data disk

Update a VM by detaching data disk

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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"
}

Definizioni

Nome	Descrizione
AdditionalCapabilities	Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale.
AdditionalUnattendContent	Specifica ulteriori informazioni in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml, che viene utilizzato dal programma di installazione di Windows.
ApiEntityReference	Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.
ApiError	Errore dell'API.
ApiErrorBase	Base degli errori api.
ApplicationProfile	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali.
AvailablePatchSummary	Riepilogo della patch disponibile dell'operazione di valutazione più recente per la macchina virtuale.
BillingProfile	Specifica i dettagli relativi alla fatturazione di una macchina virtuale spot di Azure. Versione minima api: 2019-03-01.
BootDiagnostics	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. NOTA: se si specifica storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e nella stessa sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.
BootDiagnosticsInstanceView	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.
CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
CapacityReservationProfile	Specifica informazioni sulla prenotazione di capacità usata per allocare la macchina virtuale. Versione minima api: 2021-04-01.
CloudError	Risposta di errore dal servizio di calcolo.
ComponentNames	Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.
DataDisk	Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
DeleteOptions	Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata
DiagnosticsProfile	Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.
DiffDiskOptions	Specifica le impostazioni temporanee del disco per il disco del sistema operativo.
DiffDiskPlacement	Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: cacheDisk se ne è configurato uno per le dimensioni della macchina virtuale in caso contrario viene usato ResourceDisk o NvmeDisk. Vedere la documentazione relativa alle dimensioni della macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione minima api per NvmeDisk: 2024-03-01.
DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.
DiskControllerTypes	Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.
DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.
DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.
DiskDetachOptionTypes	Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di resort per scollegare il disco forzatamente dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.
DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
DiskEncryptionSettings	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.
DiskInstanceView	Informazioni sul disco della macchina virtuale.
DomainNameLabelScopeTypes	Ambito dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generato è la concatenazione dell'etichetta del nome di dominio con hash con i criteri in base all'ambito dell'etichetta del nome di dominio e all'ID univoco del profilo di rete vm.
EncryptionIdentity	Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.
EventGridAndResourceGraph	I parametri di configurazione usati durante la creazione dell'impostazione eventGridAndResourceGraph Scheduled Event.
ExtendedLocation	Posizione estesa della macchina virtuale.
ExtendedLocationTypes	Tipo della posizione estesa.
HardwareProfile	Specifica le impostazioni hardware per la macchina virtuale.
HyperVGenerationType	Specifica il tipo HyperVGeneration associato a una risorsa
ImageReference	Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.
InnerError	Dettagli dell'errore interno.
InstanceViewStatus	Stato di visualizzazione dell'istanza.
IPVersions	Disponibile da Api-Version 2019-07-01 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.
KeyVaultKeyReference	Specifica il percorso della chiave di crittografia della chiave in Key Vault.
KeyVaultSecretReference	Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi
LastPatchInstallationSummary	Riepilogo dell'installazione dell'ultima operazione di installazione per la macchina virtuale.
LinuxConfiguration	Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.
LinuxPatchAssessmentMode	Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
LinuxPatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.
LinuxVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Linux.
LinuxVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true
MaintenanceOperationResultCodeTypes	Codice risultato dell'ultima operazione di manutenzione.
MaintenanceRedeployStatus	Stato dell'operazione di manutenzione nella macchina virtuale.
ManagedDiskParameters	Parametri del disco gestito.
Mode	Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.
NetworkApiVersion	specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete
NetworkInterfaceAuxiliaryMode	Specifica se la modalità ausiliaria è abilitata per la risorsa interfaccia di rete.
NetworkInterfaceAuxiliarySku	Specifica se lo SKU ausiliario è abilitato per la risorsa interfaccia di rete.
NetworkInterfaceReference	Specifica l'elenco di ID risorsa per le interfacce di rete associate alla macchina virtuale.
NetworkProfile	Specifica le interfacce di rete della macchina virtuale.
OperatingSystemTypes	Tipo di sistema operativo.
OSDisk	Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
OSImageNotificationProfile	Specifica le configurazioni correlate all'evento pianificato dell'immagine del sistema operativo.
OSProfile	Specifica le impostazioni del sistema operativo usate durante la creazione della macchina virtuale. Alcune impostazioni non possono essere modificate dopo il provisioning della macchina virtuale.
PassNames	Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.
PatchOperationStatus	Stato complessivo di esito positivo o negativo dell'operazione. Rimane "InProgress" fino al completamento dell'operazione. A quel punto diventerà "Unknown", "Failed", "Succeeded" o "CompletedWithWarnings".
PatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.
Plan	Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del Marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nel portale di Azure individuare l'immagine del Marketplace che si vuole usare e quindi fare clic su Si vuole distribuire a livello di codice, Introduzione ->. Immettere le informazioni necessarie e quindi fare clic su Salva.
ProtocolTypes	Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.
ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.
PublicIPAddressSku	Descrive lo SKU dell'indirizzo IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.
PublicIPAddressSkuName	Specificare il nome dello SKU IP pubblico
PublicIPAddressSkuTier	Specificare il livello SKU DELL'INDIRIZZO IP pubblico
PublicIPAllocationMethod	Specificare il tipo di allocazione IP pubblico
ResourceIdentityType	Tipo di identità usata per la macchina virtuale. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà le identità dalla macchina virtuale.
ScheduledEventsAdditionalPublishingTargets	Parametri di configurazione usati durante la pubblicazione scheduledEventsAdditionalPublishingTargets.
ScheduledEventsPolicy	Specifica le configurazioni correlate all'evento pianificato Ridistribuire, riavviare e scheduledEventsAdditionalPublishingTargets per la macchina virtuale.
ScheduledEventsProfile	Specifica le configurazioni correlate agli eventi pianificati.
securityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.
SecurityProfile	Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.
SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
SettingNames	Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.
SshConfiguration	Specifica la configurazione della chiave SSH per un sistema operativo Linux.
SshPublicKey	Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.
StatusLevelTypes	Codice a livello.
StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.
StorageProfile	Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.
SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.
TerminateNotificationProfile	Specifica le configurazioni correlate all'evento pianificato Terminate.
UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.
UserAssignedIdentities	Elenco di identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
UserInitiatedReboot	I parametri di configurazione usati durante la creazione di un'impostazione evento pianificata userInitiatedReboot.
UserInitiatedRedeploy	I parametri di configurazione usati durante la creazione dell'impostazione dell'evento pianificata userInitiatedRedeploy.
VaultCertificate	Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.
VaultSecretGroup	Specifica il set di certificati che devono essere installati nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
VirtualHardDisk	Disco rigido virtuale.
VirtualMachine	Descrive una macchina virtuale.
VirtualMachineAgentInstanceView	Agente di macchine virtuali in esecuzione nella macchina virtuale.
VirtualMachineEvictionPolicyTypes	Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.
VirtualMachineExtension	Risorse dell'estensione figlio della macchina virtuale.
VirtualMachineExtensionHandlerInstanceView	Visualizzazione dell'istanza del gestore dell'estensione macchina virtuale.
VirtualMachineExtensionInstanceView	Visualizzazione dell'istanza dell'estensione della macchina virtuale.
VirtualMachineHealthStatus	Stato di integrità per la macchina virtuale.
VirtualMachineIdentity	Identità della macchina virtuale, se configurata.
VirtualMachineInstanceView	Visualizzazione dell'istanza della macchina virtuale.
VirtualMachineIpTag	Elenco di tag IP associati all'indirizzo IP pubblico.
VirtualMachineNetworkInterfaceConfiguration	Specifica le configurazioni di rete che verranno usate per creare le risorse di rete delle macchine virtuali.
VirtualMachineNetworkInterfaceDnsSettingsConfiguration	Impostazioni DNS da applicare alle interfacce di rete.
VirtualMachineNetworkInterfaceIPConfiguration	Specifica le configurazioni IP dell'interfaccia di rete.
VirtualMachinePatchStatus	[Funzionalità di anteprima] Stato delle operazioni patch della macchina virtuale.
VirtualMachinePriorityTypes	Specifica la priorità per la macchina virtuale. Versione minima api: 2019-03-01
VirtualMachinePublicIPAddressConfiguration	PublicIPAddressConfiguration.
VirtualMachinePublicIPAddressDnsSettingsConfiguration	Impostazioni DNS da applicare agli indirizzi publicIP.
VirtualMachineSizeTypes	Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: Elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.
VirtualMachineUpdate	Parametri forniti all'operazione Aggiorna macchina virtuale.
VMDiskSecurityProfile	Specifica il profilo di sicurezza per il disco gestito.
VMGalleryApplication	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali
VMSizeProperties	Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altri dettagli, seguire le istruzioni riportate in di personalizzazione della macchina virtuale.
WindowsConfiguration	Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.
WindowsPatchAssessmentMode	Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.
WindowsVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Windows.
WindowsVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true
WinRMConfiguration	Specifica i listener di Gestione remota Windows. In questo modo si abilita Windows PowerShell remoto.
WinRMListener	Elenco di listener di Gestione remota Windows

AdditionalCapabilities

Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale.

Nome	Tipo	Descrizione
hibernationEnabled	boolean	Flag che abilita o disabilita la funzionalità di ibernazione nella macchina virtuale.
ultraSSDEnabled	boolean	Flag che abilita o disabilita una funzionalità per avere uno o più dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione nella macchina virtuale o nel set di scalabilità di macchine virtuali. I dischi gestiti con tipo di account di archiviazione UltraSSD_LRS possono essere aggiunti a una macchina virtuale o a un set di scalabilità di macchine virtuali solo se questa proprietà è abilitata.

AdditionalUnattendContent

Specifica ulteriori informazioni in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml, che viene utilizzato dal programma di installazione di Windows.

Nome	Tipo	Descrizione
componentName	ComponentNames	Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.
content	string	Specifica il contenuto in formato XML aggiunto al file unattend.xml per il percorso e il componente specificati. Il codice XML deve essere minore di 4 KB e deve includere l'elemento radice per l'impostazione o la funzionalità da inserire.
passName	PassNames	Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.
settingName	SettingNames	Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

ApiEntityReference

Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.

Nome	Tipo	Descrizione
id	string	ID risorsa ARM sotto forma di /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Errore dell'API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore dell'API
innererror	InnerError	Errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApplicationProfile

Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
galleryApplications	VMGalleryApplication[]	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali

AvailablePatchSummary

Riepilogo della patch disponibile dell'operazione di valutazione più recente per la macchina virtuale.

Nome	Tipo	Descrizione
assessmentActivityId	string	ID attività dell'operazione che ha prodotto questo risultato. Viene usato per correlare i log di estensione e CRP.
criticalAndSecurityPatchCount	integer	Numero di patch critiche o di sicurezza rilevate come disponibili e non ancora installate.
error	ApiError	Errori rilevati durante l'esecuzione dell'operazione. La matrice dei dettagli contiene l'elenco di essi.
lastModifiedTime	string	Timestamp UTC all'avvio dell'operazione.
otherPatchCount	integer	Numero di tutte le patch disponibili escluse la sicurezza e la criticità.
rebootPending	boolean	Stato di riavvio complessivo della macchina virtuale. Sarà vero quando le patch parzialmente installate richiedono un riavvio per completare l'installazione, ma il riavvio non si è ancora verificato.
startTime	string	Timestamp UTC all'avvio dell'operazione.
status	PatchOperationStatus	Stato complessivo di esito positivo o negativo dell'operazione. Rimane "InProgress" fino al completamento dell'operazione. A quel punto diventerà "Unknown", "Failed", "Succeeded" o "CompletedWithWarnings".

BillingProfile

Specifica i dettagli relativi alla fatturazione di una macchina virtuale spot di Azure. Versione minima api: 2019-03-01.

Nome	Tipo	Descrizione
maxPrice	number	Specifica il prezzo massimo che si vuole pagare per una macchina virtuale/set di scalabilità di macchine virtuali spot di Azure. Questo prezzo è in dollari USA. Questo prezzo verrà confrontato con il prezzo corrente di Azure Spot per le dimensioni della macchina virtuale. Inoltre, i prezzi vengono confrontati al momento della creazione/aggiornamento di macchine virtuali spot di Azure/SET di scalabilità di macchine virtuali e l'operazione avrà esito positivo solo se il prezzo maxPrice è maggiore del prezzo corrente di Azure Spot. MaxPrice verrà usato anche per rimuovere una macchina virtuale/set di scalabilità di macchine virtuali spot di Azure se il prezzo corrente di Azure Spot supera il valore maxPrice dopo la creazione di macchine virtuali/set di scalabilità di macchine virtuali. I valori possibili sono: - Qualsiasi valore decimale maggiore di zero. Esempio: 0.01538 -1 : indica il prezzo predefinito da up-to su richiesta. È possibile impostare maxPrice su -1 per indicare che la macchina virtuale/set di scalabilità di macchine virtuali spot di Azure non deve essere eliminata per motivi di prezzo. Inoltre, il prezzo massimo predefinito è -1 se non è fornito dall'utente. Versione minima api: 2019-03-01.

BootDiagnostics

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. NOTA: se si specifica storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e nella stessa sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

Nome	Tipo	Descrizione
enabled	boolean	Indica se la diagnostica di avvio deve essere abilitata nella macchina virtuale.
storageUri	string	URI dell'account di archiviazione da usare per inserire l'output e lo screenshot della console. Se storageUri non viene specificato durante l'abilitazione della diagnostica di avvio, verrà usata l'archiviazione gestita.

BootDiagnosticsInstanceView

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

Nome	Tipo	Descrizione
consoleScreenshotBlobUri	string	Screenshot dell'URI BLOB della console. Nota: Questa impostazione non se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.
serialConsoleLogBlobUri	string	Uri BLOB del log della console seriale. Nota: Questa impostazione non se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.
status	InstanceViewStatus	Informazioni sullo stato di diagnostica di avvio per la macchina virtuale. Nota: Verrà impostato solo se si verificano errori durante l'abilitazione della diagnostica di avvio.

CachingTypes

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

Nome	Tipo	Descrizione
None	string
ReadOnly	string
ReadWrite	string

CapacityReservationProfile

Specifica informazioni sulla prenotazione di capacità usata per allocare la macchina virtuale. Versione minima api: 2021-04-01.

Nome	Tipo	Descrizione
capacityReservationGroup	SubResource	Specifica l'ID risorsa del gruppo di prenotazioni di capacità che deve essere usato per allocare la macchina virtuale o le istanze di vm del set di scalabilità a condizione che sia stata riservata una capacità sufficiente. Per altri dettagli, vedere https://aka.ms/CapacityReservation.

CloudError

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore dell'API.

ComponentNames

Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.

Nome	Tipo	Descrizione
Microsoft-Windows-Shell-Setup	string

DataDisk

Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare il disco dati della macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza. Vuoto: Questo valore viene usato durante la creazione di un disco dati vuoto. Copia: Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Restore: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco dati deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco dati viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco dati viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach.
detachOption	DiskDetachOptionTypes	Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di resort per scollegare il disco forzatamente dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.
diskIOPSReadWrite	integer	Specifica il Read-Write operazioni di I/O al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi delle macchine virtuali VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.
diskMBpsReadWrite	integer	Specifica la larghezza di banda in MB al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi delle macchine virtuali VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.
diskSizeGB	integer	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
image	VirtualHardDisk	Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se sourceImage è specificato, il disco rigido virtuale di destinazione non deve esistere.
lun	integer	Specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale.
managedDisk	ManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
sourceResource	ApiEntityReference	Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.
toBeDetached	boolean	Specifica se il disco dati è in corso di scollegamento da VirtualMachine/VirtualMachineScaleset
vhd	VirtualHardDisk	Disco rigido virtuale.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

DeleteOptions

Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata

Nome	Tipo	Descrizione
Delete	string
Detach	string

DiagnosticsProfile

Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.

Nome	Tipo	Descrizione
bootDiagnostics	BootDiagnostics	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. NOTA: se si specifica storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e nella stessa sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

DiffDiskOptions

Specifica le impostazioni temporanee del disco per il disco del sistema operativo.

Nome	Tipo	Descrizione
Local	string

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: cacheDisk se ne è configurato uno per le dimensioni della macchina virtuale in caso contrario viene usato ResourceDisk o NvmeDisk. Vedere la documentazione relativa alle dimensioni della macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione minima api per NvmeDisk: 2024-03-01.

Nome	Tipo	Descrizione
CacheDisk	string
NvmeDisk	string
ResourceDisk	string

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.

Nome	Tipo	Descrizione
option	DiffDiskOptions	Specifica le impostazioni temporanee del disco per il disco del sistema operativo.
placement	DiffDiskPlacement	Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: cacheDisk se ne è configurato uno per le dimensioni della macchina virtuale in caso contrario viene usato ResourceDisk o NvmeDisk. Vedere la documentazione relativa alle dimensioni della macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione minima api per NvmeDisk: 2024-03-01.

DiskControllerTypes

Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.

Nome	Tipo	Descrizione
NVMe	string
SCSI	string

DiskCreateOptionTypes

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.

Nome	Tipo	Descrizione
Attach	string
Copy	string
Empty	string
FromImage	string
Restore	string

DiskDeleteOptionTypes

Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.

Nome	Tipo	Descrizione
Delete	string
Detach	string

DiskDetachOptionTypes

Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di resort per scollegare il disco forzatamente dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.

Nome	Tipo	Descrizione
ForceDetach	string

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

Nome	Tipo	Descrizione
id	string	ID risorsa

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.

Nome	Tipo	Descrizione
diskEncryptionKey	KeyVaultSecretReference	Specifica il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi.
enabled	boolean	Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.
keyEncryptionKey	KeyVaultKeyReference	Specifica il percorso della chiave di crittografia della chiave in Key Vault.

DiskInstanceView

Informazioni sul disco della macchina virtuale.

Nome	Tipo	Descrizione
encryptionSettings	DiskEncryptionSettings[]	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15
name	string	Nome del disco.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.

DomainNameLabelScopeTypes

Ambito dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generato è la concatenazione dell'etichetta del nome di dominio con hash con i criteri in base all'ambito dell'etichetta del nome di dominio e all'ID univoco del profilo di rete vm.

Nome	Tipo	Descrizione
NoReuse	string
ResourceGroupReuse	string
SubscriptionReuse	string
TenantReuse	string

EncryptionIdentity

Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
userAssignedIdentityResourceId	string	Specifica l'ID risorsa ARM di una delle identità utente associate alla macchina virtuale.

EventGridAndResourceGraph

I parametri di configurazione usati durante la creazione dell'impostazione eventGridAndResourceGraph Scheduled Event.

Nome	Tipo	Descrizione
enable	boolean	Specifica se griglia di eventi e grafico delle risorse è abilitato per le configurazioni correlate agli eventi pianificati.

ExtendedLocation

Posizione estesa della macchina virtuale.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationTypes	Tipo della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

Nome	Tipo	Descrizione
EdgeZone	string

HardwareProfile

Specifica le impostazioni hardware per la macchina virtuale.

Nome	Tipo	Descrizione
vmSize	VirtualMachineSizeTypes	Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: Elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.
vmSizeProperties	VMSizeProperties	Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altri dettagli, seguire le istruzioni riportate in di personalizzazione della macchina virtuale.

HyperVGenerationType

Specifica il tipo HyperVGeneration associato a una risorsa

Nome	Tipo	Descrizione
V1	string
V2	string

ImageReference

Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.

Nome	Tipo	Descrizione
communityGalleryImageId	string	È stato specificato l'ID univoco dell'immagine della raccolta della community per la distribuzione di macchine virtuali. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta della community.
exactVersion	string	Specifica in numeri decimali la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'.
id	string	ID risorsa
offer	string	Specifica l'offerta dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale.
publisher	string	Autore dell'immagine.
sharedGalleryImageId	string	È stato specificato l'ID univoco dell'immagine della raccolta condivisa per la distribuzione della macchina virtuale. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta condivisa.
sku	string	SKU dell'immagine.
version	string	Specifica la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. I formati consentiti sono Major.Minor.Build o 'latest'. Major, Minor e Build sono numeri decimali. Specificare 'latest' per usare la versione più recente di un'immagine disponibile in fase di distribuzione. Anche se si usa 'latest', l'immagine della macchina virtuale non verrà aggiornata automaticamente dopo la distribuzione anche se diventa disponibile una nuova versione. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve usare sempre il campo 'id' per la distribuzione, per usare la versione più recente dell'immagine della raccolta, è sufficiente impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input della versione.

InnerError

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump delle eccezioni.
exceptiontype	string	Tipo di eccezione.

InstanceViewStatus

Stato di visualizzazione dell'istanza.

Nome	Tipo	Descrizione
code	string	Codice di stato.
displayStatus	string	Etichetta localizzabile breve per lo stato.
level	StatusLevelTypes	Codice a livello.
message	string	Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore.
time	string	Ora dello stato.

IPVersions

Disponibile da Api-Version 2019-07-01 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

Nome	Tipo	Descrizione
IPv4	string
IPv6	string

KeyVaultKeyReference

Specifica il percorso della chiave di crittografia della chiave in Key Vault.

Nome	Tipo	Descrizione
keyUrl	string	URL che fa riferimento a una chiave di crittografia della chiave in Key Vault.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente la chiave.

KeyVaultSecretReference

Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi

Nome	Tipo	Descrizione
secretUrl	string	URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.

LastPatchInstallationSummary

Riepilogo dell'installazione dell'ultima operazione di installazione per la macchina virtuale.

Nome	Tipo	Descrizione
error	ApiError	Errori rilevati durante l'esecuzione dell'operazione. La matrice dei dettagli contiene l'elenco di essi.
excludedPatchCount	integer	Numero di tutte le patch disponibili, ma escluse in modo esplicito da una corrispondenza dell'elenco di esclusione specificato dal cliente.
failedPatchCount	integer	Numero di patch che non sono riuscite all'installazione.
installationActivityId	string	ID attività dell'operazione che ha prodotto questo risultato. Viene usato per correlare i log di estensione e CRP.
installedPatchCount	integer	Numero di patch installate correttamente.
lastModifiedTime	string	Timestamp UTC all'avvio dell'operazione.
maintenanceWindowExceeded	boolean	Descrive se l'operazione è esaurita prima del completamento di tutte le azioni desiderate
notSelectedPatchCount	integer	Il numero di tutte le patch disponibili ma non verrà installato perché non corrisponde a una voce di elenco di classificazione o inclusione.
pendingPatchCount	integer	Numero di tutte le patch disponibili che dovrebbero essere installate nel corso dell'operazione di installazione delle patch.
startTime	string	Timestamp UTC all'avvio dell'operazione.
status	PatchOperationStatus	Stato complessivo di esito positivo o negativo dell'operazione. Rimane "InProgress" fino al completamento dell'operazione. A quel punto diventerà "Unknown", "Failed", "Succeeded" o "CompletedWithWarnings".

LinuxConfiguration

Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.

Nome	Tipo	Descrizione
disablePasswordAuthentication	boolean	Specifica se l'autenticazione della password deve essere disabilitata.
enableVMAgentPlatformUpdates	boolean	Indica se gli aggiornamenti della piattaforma VMAgent sono abilitati per la macchina virtuale Linux. Il valore predefinito è false.
patchSettings	LinuxPatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.
provisionVMAgent	boolean	Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nella macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo su true. In questo modo si garantisce che l'agente di macchine virtuali sia installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.
ssh	SshConfiguration	Specifica la configurazione della chiave SSH per un sistema operativo Linux.

LinuxPatchAssessmentMode

Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.

Nome	Tipo	Descrizione
assessmentMode	LinuxPatchAssessmentMode	Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Linux.
patchMode	LinuxVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

Nome	Tipo	Descrizione
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Linux.

Nome	Tipo	Descrizione
bypassPlatformSafetyChecksOnUserSchedule	boolean	Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

LinuxVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale.

AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

MaintenanceOperationResultCodeTypes

Codice risultato dell'ultima operazione di manutenzione.

Nome	Tipo	Descrizione
MaintenanceAborted	string
MaintenanceCompleted	string
None	string
RetryLater	string

MaintenanceRedeployStatus

Stato dell'operazione di manutenzione nella macchina virtuale.

Nome	Tipo	Descrizione
isCustomerInitiatedMaintenanceAllowed	boolean	True, se il cliente è autorizzato a eseguire la manutenzione.
lastOperationMessage	string	Messaggio restituito per l'ultima operazione di manutenzione.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	Codice risultato dell'ultima operazione di manutenzione.
maintenanceWindowEndTime	string	Ora di fine per la finestra di manutenzione.
maintenanceWindowStartTime	string	Ora di inizio per la finestra di manutenzione.
preMaintenanceWindowEndTime	string	Ora di fine per la finestra di manutenzione preliminare.
preMaintenanceWindowStartTime	string	Ora di inizio per la finestra di manutenzione preliminare.

ManagedDiskParameters

Parametri del disco gestito.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
id	string	ID risorsa
securityProfile	VMDiskSecurityProfile	Specifica il profilo di sicurezza per il disco gestito.
storageAccountType	StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

Mode

Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.

Nome	Tipo	Descrizione
Audit	string
Enforce	string

NetworkApiVersion

specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete

Nome	Tipo	Descrizione
2020-11-01	string

NetworkInterfaceAuxiliaryMode

Specifica se la modalità ausiliaria è abilitata per la risorsa interfaccia di rete.

Nome	Tipo	Descrizione
AcceleratedConnections	string
Floating	string
None	string

NetworkInterfaceAuxiliarySku

Specifica se lo SKU ausiliario è abilitato per la risorsa interfaccia di rete.

Nome	Tipo	Descrizione
A1	string
A2	string
A4	string
A8	string
None	string

NetworkInterfaceReference

Specifica l'elenco di ID risorsa per le interfacce di rete associate alla macchina virtuale.

Nome	Tipo	Descrizione
id	string	ID risorsa
properties.deleteOption	DeleteOptions	Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata
properties.primary	boolean	Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

NetworkProfile

Specifica le interfacce di rete della macchina virtuale.

Nome	Tipo	Descrizione
networkApiVersion	NetworkApiVersion	specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete
networkInterfaceConfigurations	VirtualMachineNetworkInterfaceConfiguration[]	Specifica le configurazioni di rete che verranno usate per creare le risorse di rete delle macchine virtuali.
networkInterfaces	NetworkInterfaceReference[]	Specifica l'elenco di ID risorsa per le interfacce di rete associate alla macchina virtuale.

OperatingSystemTypes

Tipo di sistema operativo.

Nome	Tipo	Descrizione
Linux	string
Windows	string

OSDisk

Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.
diffDiskSettings	DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.
diskSizeGB	integer	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
encryptionSettings	DiskEncryptionSettings	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.
image	VirtualHardDisk	Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se sourceImage è specificato, il disco rigido virtuale di destinazione non deve esistere.
managedDisk	ManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
osType	OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine utente o un disco rigido virtuale specializzato. I valori possibili sono: Windows,Linux.
vhd	VirtualHardDisk	Disco rigido virtuale.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

OSImageNotificationProfile

Specifica le configurazioni correlate all'evento pianificato dell'immagine del sistema operativo.

Nome	Tipo	Descrizione
enable	boolean	Specifica se l'evento Pianificato immagine del sistema operativo è abilitato o disabilitato.
notBeforeTimeout	string	Tempo durante la ricreazione dell'immagine di una macchina virtuale o l'aggiornamento del sistema operativo dovrà potenzialmente approvare l'evento pianificato dell'immagine del sistema operativo prima dell'approvazione automatica dell'evento (timeout). La configurazione viene specificata in formato ISO 8601 e il valore deve essere 15 minuti (PT15M)

OSProfile

Specifica le impostazioni del sistema operativo usate durante la creazione della macchina virtuale. Alcune impostazioni non possono essere modificate dopo il provisioning della macchina virtuale.

Nome	Tipo	Descrizione
adminPassword	string	Specifica la password dell'account amministratore. Lunghezza minima (Windows): 8 caratteri Lunghezza minima (Linux): 6 caratteri Lunghezza massima (Windows): 123 caratteri Lunghezza massima (Linux): 72 caratteri requisiti di complessità: è necessario soddisfare 3 su 4 condizioni seguenti Ha caratteri inferiori Ha caratteri superiori Ha una cifra Ha un carattere speciale (corrispondenza regex [\W_]) Valori non consentiti: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" Per reimpostare la password, vedere Come reimpostare il servizio Desktop remoto o la relativa password di accesso in una macchina virtuale Windows Per reimpostare la password radice, vedere Gestire utenti, SSH e controllare o ripristinare i dischi in macchine virtuali Linux di Azure usando l'estensione VMAccess
adminUsername	string	Specifica il nome dell'account amministratore. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. restrizione solo Windows: Non è possibile terminare in "." Valori non consentiti: "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". lunghezza minima (Linux): 1 carattere Lunghezza massima (Linux): 64 caratteri Lunghezza massima (Windows): 20 caratteri.
allowExtensionOperations	boolean	Specifica se le operazioni di estensione devono essere consentite nella macchina virtuale. Questa impostazione può essere impostata su False solo quando non sono presenti estensioni nella macchina virtuale.
computerName	string	Specifica il nome del sistema operativo host della macchina virtuale. Questo nome non può essere aggiornato dopo la creazione della macchina virtuale. Lunghezza massima (Windows): 15 caratteri. Lunghezza massima (Linux): 64 caratteri. Per le convenzioni di denominazione e le restrizioni, vedere linee guida per l'implementazione dei servizi dell'infrastruttura di Azure.
customData	string	Specifica una stringa con codifica base 64 di dati personalizzati. La stringa con codifica base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è di 65535 byte. Nota: non passare segreti o password nella proprietà customData. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. La proprietà 'customData' viene passata alla macchina virtuale da salvare come file. Per altre informazioni, vedere dati personalizzati nelle macchine virtuali di Azure. Per l'uso di cloud-init per la macchina virtuale Linux, vedere Uso di cloud-init per personalizzare una macchina virtuale Linux durante la creazione.
linuxConfiguration	LinuxConfiguration	Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.
requireGuestProvisionSignal	boolean	Proprietà facoltativa che deve essere impostata su True o omessa.
secrets	VaultSecretGroup[]	Specifica il set di certificati che devono essere installati nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
windowsConfiguration	WindowsConfiguration	Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

PassNames

Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.

Nome	Tipo	Descrizione
OobeSystem	string

PatchOperationStatus

Stato complessivo di esito positivo o negativo dell'operazione. Rimane "InProgress" fino al completamento dell'operazione. A quel punto diventerà "Unknown", "Failed", "Succeeded" o "CompletedWithWarnings".

Nome	Tipo	Descrizione
CompletedWithWarnings	string
Failed	string
InProgress	string
Succeeded	string
Unknown	string

PatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.

Nome	Tipo	Descrizione
assessmentMode	WindowsPatchAssessmentMode	Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Windows.
enableHotpatching	boolean	Consente ai clienti di applicare patch alle macchine virtuali di Azure senza richiedere un riavvio. Per enableHotpatching, 'provisionVMAgent' deve essere impostato su true e 'patchMode' deve essere impostato su 'AutomaticByPlatform'.
patchMode	WindowsVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

Plan

Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del Marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nel portale di Azure individuare l'immagine del Marketplace che si vuole usare e quindi fare clic su Si vuole distribuire a livello di codice, Introduzione ->. Immettere le informazioni necessarie e quindi fare clic su Salva.

Nome	Tipo	Descrizione
name	string	ID del piano.
product	string	Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference.
promotionCode	string	Codice promozionale.
publisher	string	ID editore.

ProtocolTypes

Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.

Nome	Tipo	Descrizione
Http	string
Https	string

ProxyAgentSettings

Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.

Nome	Tipo	Descrizione
enabled	boolean	Specifica se la funzionalità ProxyAgent deve essere abilitata nella macchina virtuale o nel set di scalabilità di macchine virtuali.
keyIncarnationId	integer	Aumentare il valore di questa proprietà consente all'utente di reimpostare la chiave usata per proteggere il canale di comunicazione tra guest e host.
mode	Mode	Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.

PublicIPAddressSku

Descrive lo SKU dell'indirizzo IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

Nome	Tipo	Descrizione
name	PublicIPAddressSkuName	Specificare il nome dello SKU IP pubblico
tier	PublicIPAddressSkuTier	Specificare il livello SKU DELL'INDIRIZZO IP pubblico

PublicIPAddressSkuName

Specificare il nome dello SKU IP pubblico

Nome	Tipo	Descrizione
Basic	string
Standard	string

PublicIPAddressSkuTier

Specificare il livello SKU DELL'INDIRIZZO IP pubblico

Nome	Tipo	Descrizione
Global	string
Regional	string

PublicIPAllocationMethod

Specificare il tipo di allocazione IP pubblico

Nome	Tipo	Descrizione
Dynamic	string
Static	string

ResourceIdentityType

Tipo di identità usata per la macchina virtuale. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà le identità dalla macchina virtuale.

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

ScheduledEventsAdditionalPublishingTargets

Parametri di configurazione usati durante la pubblicazione scheduledEventsAdditionalPublishingTargets.

Nome	Tipo	Descrizione
eventGridAndResourceGraph	EventGridAndResourceGraph	I parametri di configurazione usati durante la creazione dell'impostazione eventGridAndResourceGraph Scheduled Event.

ScheduledEventsPolicy

Specifica le configurazioni correlate all'evento pianificato Ridistribuire, riavviare e scheduledEventsAdditionalPublishingTargets per la macchina virtuale.

Nome	Tipo	Descrizione
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Parametri di configurazione usati durante la pubblicazione scheduledEventsAdditionalPublishingTargets.
userInitiatedReboot	UserInitiatedReboot	I parametri di configurazione usati durante la creazione di un'impostazione evento pianificata userInitiatedReboot.
userInitiatedRedeploy	UserInitiatedRedeploy	I parametri di configurazione usati durante la creazione dell'impostazione dell'evento pianificata userInitiatedRedeploy.

ScheduledEventsProfile

Specifica le configurazioni correlate agli eventi pianificati.

Nome	Tipo	Descrizione
osImageNotificationProfile	OSImageNotificationProfile	Specifica le configurazioni correlate all'evento pianificato dell'immagine del sistema operativo.
terminateNotificationProfile	TerminateNotificationProfile	Specifica le configurazioni correlate all'evento pianificato Terminate.

securityEncryptionTypes

Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.

Nome	Tipo	Descrizione
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.

Nome	Tipo	Descrizione
encryptionAtHost	boolean	Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Il comportamento predefinito è: la crittografia dell'host verrà disabilitata a meno che questa proprietà non sia impostata su true per la risorsa.
encryptionIdentity	EncryptionIdentity	Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.
proxyAgentSettings	ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.
securityType	SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
uefiSettings	UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

SecurityTypes

Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.

Nome	Tipo	Descrizione
ConfidentialVM	string
TrustedLaunch	string

SettingNames

Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

Nome	Tipo	Descrizione
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

Specifica la configurazione della chiave SSH per un sistema operativo Linux.

Nome	Tipo	Descrizione
publicKeys	SshPublicKey[]	Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

SshPublicKey

Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

Nome	Tipo	Descrizione
keyData	string	Certificato di chiave pubblica SSH usato per l'autenticazione con la macchina virtuale tramite ssh. La chiave deve essere almeno a 2048 bit e in formato ssh-rsa. Per la creazione di chiavi SSH, vedere [Creare chiavi SSH in Linux e Mac per macchine virtuali Linux in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Specifica il percorso completo nella macchina virtuale creata in cui è archiviata la chiave pubblica SSH. Se il file esiste già, la chiave specificata viene aggiunta al file. Esempio: /home/user/.ssh/authorized_keys

StatusLevelTypes

Codice a livello.

Nome	Tipo	Descrizione
Error	string
Info	string
Warning	string

StorageAccountTypes

Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

Nome	Tipo	Descrizione
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

StorageProfile

Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.

Nome	Tipo	Descrizione
dataDisks	DataDisk[]	Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
diskControllerType	DiskControllerTypes	Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.
imageReference	ImageReference	Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.
osDisk	OSDisk	Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

SubResource

URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.

Nome	Tipo	Descrizione
id	string	ID risorsa

TerminateNotificationProfile

Specifica le configurazioni correlate all'evento pianificato Terminate.

Nome	Tipo	Descrizione
enable	boolean	Specifica se l'evento Terminate Scheduled è abilitato o disabilitato.
notBeforeTimeout	string	La durata configurabile dell'eliminazione di una macchina virtuale dovrà potenzialmente approvare l'evento pianificato terminate prima che l'evento venga approvato automaticamente (timeout). La configurazione deve essere specificata in formato ISO 8601, il valore predefinito è 5 minuti (PT5M)

UefiSettings

Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

Nome	Tipo	Descrizione
secureBootEnabled	boolean	Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.
vTpmEnabled	boolean	Specifica se vTPM deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.

UserAssignedIdentities

Elenco di identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nome	Tipo	Descrizione

UserInitiatedReboot

I parametri di configurazione usati durante la creazione di un'impostazione evento pianificata userInitiatedReboot.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica le configurazioni correlate all'evento pianificato per il riavvio.

UserInitiatedRedeploy

I parametri di configurazione usati durante la creazione dell'impostazione dell'evento pianificata userInitiatedRedeploy.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica le configurazioni correlate all'evento pianificato ridistribuire.

VaultCertificate

Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

Nome	Tipo	Descrizione
certificateStore	string	Per le macchine virtuali Windows, specifica l'archivio certificati nella macchina virtuale a cui aggiungere il certificato. L'archivio certificati specificato è in modo implicito nell'account LocalMachine. Per le macchine virtuali Linux, il file di certificato viene inserito nella directory /var/lib/waagent, con il nome file <UppercaseThumbprint>.crt per il file di certificato X509 e <UppercaseThumbprint>.prv per la chiave privata. Entrambi questi file sono formattati con estensione pem.
certificateUrl	string	Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto all'insieme di credenziali delle chiavi, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere La codifica Base64 dell'oggetto JSON seguente codificato in UTF-8: { "data":"", "dataType":"pfx", "password":"" } Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

VaultSecretGroup

Specifica il set di certificati che devono essere installati nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

Nome	Tipo	Descrizione
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente tutti i certificati in VaultCertificates.
vaultCertificates	VaultCertificate[]	Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

VirtualHardDisk

Disco rigido virtuale.

Nome	Tipo	Descrizione
uri	string	Specifica l'URI del disco rigido virtuale.

VirtualMachine

Descrive una macchina virtuale.

Nome	Tipo	Descrizione
etag	string	Etag è la proprietà restituita nella risposta Create/Update/Get della macchina virtuale, in modo che il cliente possa fornirlo nell'intestazione per garantire gli aggiornamenti ottimistici.
extendedLocation	ExtendedLocation	Posizione estesa della macchina virtuale.
id	string	ID risorsa
identity	VirtualMachineIdentity	Identità della macchina virtuale, se configurata.
location	string	Percorso risorsa
managedBy	string	ManagedBy è impostato su Virtual Machine Scale Set (VMSS) flex ARM resourceID, se la macchina virtuale fa parte del set di scalabilità di macchine virtuali. Questa proprietà viene usata dalla piattaforma per l'ottimizzazione dell'eliminazione del gruppo di risorse interno.
name	string	Nome risorsa
plan	Plan	Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del Marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nel portale di Azure individuare l'immagine del Marketplace che si vuole usare e quindi fare clic su Si vuole distribuire a livello di codice, Introduzione ->. Immettere le informazioni necessarie e quindi fare clic su Salva.
properties.additionalCapabilities	AdditionalCapabilities	Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale.
properties.applicationProfile	ApplicationProfile	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali.
properties.availabilitySet	SubResource	Specifica le informazioni sul set di disponibilità a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità. Per altre informazioni sui set di disponibilità, vedere panoramica dei set di disponibilità . Per altre informazioni sulla manutenzione pianificata di Azure, vedere manutenzione e aggiornamenti di per le macchine virtuali in Azure. Attualmente, una macchina virtuale può essere aggiunta solo al set di disponibilità in fase di creazione. Il set di disponibilità a cui viene aggiunta la macchina virtuale deve trovarsi nello stesso gruppo di risorse della risorsa del set di disponibilità. Non è possibile aggiungere una macchina virtuale esistente a un set di disponibilità. Questa proprietà non può esistere insieme a un riferimento properties non null.virtualMachineScaleSet.
properties.billingProfile	BillingProfile	Specifica i dettagli relativi alla fatturazione di una macchina virtuale spot di Azure. Versione minima api: 2019-03-01.
properties.capacityReservation	CapacityReservationProfile	Specifica informazioni sulla prenotazione di capacità usata per allocare la macchina virtuale. Versione minima api: 2021-04-01.
properties.diagnosticsProfile	DiagnosticsProfile	Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.
properties.evictionPolicy	VirtualMachineEvictionPolicyTypes	Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.
properties.extensionsTimeBudget	string	Specifica il tempo assegnato per l'avvio di tutte le estensioni. La durata deve essere compresa tra 15 minuti e 120 minuti (inclusi) e deve essere specificata in formato ISO 8601. Il valore predefinito è 90 minuti (PT1H30M). Versione minima api: 2020-06-01.
properties.hardwareProfile	HardwareProfile	Specifica le impostazioni hardware per la macchina virtuale.
properties.host	SubResource	Specifica informazioni sull'host dedicato in cui risiede la macchina virtuale. Versione minima api: 2018-10-01.
properties.hostGroup	SubResource	Specifica le informazioni sul gruppo host dedicato in cui risiede la macchina virtuale. Nota: Utente non può specificare le proprietà host e hostGroup. Versione minima api: 2020-06-01.
properties.instanceView	VirtualMachineInstanceView	Visualizzazione dell'istanza della macchina virtuale.
properties.licenseType	string	Specifica che l'immagine o il disco usato è stato concesso in licenza in locale. I valori possibili per il sistema operativo Windows Server sono: Windows_Client Windows_Server I valori possibili per il sistema operativo Linux Server sono: RHEL_BYOS (per RHEL) SLES_BYOS (per SUSE) Per altre informazioni, vedere Vantaggio Azure Hybrid Use per Windows Server Vantaggio Azure Hybrid Use per Linux Server Versione minima api: 2015-06-15
properties.networkProfile	NetworkProfile	Specifica le interfacce di rete della macchina virtuale.
properties.osProfile	OSProfile	Specifica le impostazioni del sistema operativo usate durante la creazione della macchina virtuale. Alcune impostazioni non possono essere modificate dopo il provisioning della macchina virtuale.
properties.platformFaultDomain	integer	Specifica il dominio di errore logico del set di scalabilità in cui verrà creata la macchina virtuale. Per impostazione predefinita, la macchina virtuale verrà assegnata automaticamente a un dominio di errore che mantiene al meglio il bilanciamento tra domini di errore disponibili. Questa opzione è applicabile solo se la proprietà 'virtualMachineScaleSet' di questa macchina virtuale è impostata. Il set di scalabilità di macchine virtuali a cui si fa riferimento deve avere 'platformFaultDomainCount' maggiore di 1. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. L'assegnazione del dominio di errore può essere visualizzata nella visualizzazione Istanza macchina virtuale. Api minima versione: 2020^12-01.
properties.priority	VirtualMachinePriorityTypes	Specifica la priorità per la macchina virtuale. Versione minima api: 2019-03-01
properties.provisioningState	string	Stato di provisioning, visualizzato solo nella risposta.
properties.proximityPlacementGroup	SubResource	Specifica informazioni sul gruppo di posizionamento di prossimità a cui deve essere assegnata la macchina virtuale. Versione minima api: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Specifica le configurazioni correlate all'evento pianificato Ridistribuire, riavviare e scheduledEventsAdditionalPublishingTargets per la macchina virtuale.
properties.scheduledEventsProfile	ScheduledEventsProfile	Specifica le configurazioni correlate agli eventi pianificati.
properties.securityProfile	SecurityProfile	Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.
properties.storageProfile	StorageProfile	Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.
properties.timeCreated	string	Specifica l'ora in cui è stata creata la risorsa macchina virtuale. Versione minima api: 2021-11-01.
properties.userData	string	UserData per la macchina virtuale, che deve essere codificata in base 64. Il cliente non deve passare segreti qui. Versione minima api: 2021-03-01.
properties.virtualMachineScaleSet	SubResource	Specifica informazioni sul set di scalabilità di macchine virtuali a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di scalabilità di macchine virtuali vengono allocate a nodi diversi per ottimizzare la disponibilità. Attualmente, una macchina virtuale può essere aggiunta solo al set di scalabilità di macchine virtuali in fase di creazione. Non è possibile aggiungere una macchina virtuale esistente a un set di scalabilità di macchine virtuali. Questa proprietà non può esistere insieme a un riferimento properties.availabilitySet non Null. Api minima version: 2019^03^01.
properties.vmId	string	Specifica l'ID univoco della macchina virtuale che è un identificatore a 128 bit codificato e archiviato in tutte le macchine virtuali IaaS di Azure SMBIOS e può essere letto usando i comandi BIOS della piattaforma.
resources	VirtualMachineExtension[]	Risorse dell'estensione figlio della macchina virtuale.
tags	object	Tag delle risorse
type	string	Tipo di risorsa
zones	string[]	Zone della macchina virtuale.

VirtualMachineAgentInstanceView

Agente di macchine virtuali in esecuzione nella macchina virtuale.

Nome	Tipo	Descrizione
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	Visualizzazione dell'istanza del gestore dell'estensione macchina virtuale.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
vmAgentVersion	string	Versione completa dell'agente di macchine virtuali.

VirtualMachineEvictionPolicyTypes

Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.

Nome	Tipo	Descrizione
Deallocate	string
Delete	string

VirtualMachineExtension

Risorse dell'estensione figlio della macchina virtuale.

Nome	Tipo	Descrizione
id	string	ID risorsa
location	string	Percorso risorsa
name	string	Nome risorsa
properties.autoUpgradeMinorVersion	boolean	Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.
properties.enableAutomaticUpgrade	boolean	Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.
properties.forceUpdateTag	string	Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata.
properties.instanceView	VirtualMachineExtensionInstanceView	Visualizzazione dell'istanza dell'estensione della macchina virtuale.
properties.protectedSettings	object	L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
properties.protectedSettingsFromKeyVault	KeyVaultSecretReference	Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi
properties.provisionAfterExtensions	string[]	Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.
properties.provisioningState	string	Stato di provisioning, visualizzato solo nella risposta.
properties.publisher	string	Nome del server di pubblicazione del gestore dell'estensione.
properties.settings	object	Impostazioni pubbliche in formato JSON per l'estensione.
properties.suppressFailures	boolean	Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false.
properties.type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
properties.typeHandlerVersion	string	Specifica la versione del gestore di script.
tags	object	Tag delle risorse
type	string	Tipo di risorsa

VirtualMachineExtensionHandlerInstanceView

Visualizzazione dell'istanza del gestore dell'estensione macchina virtuale.

Nome	Tipo	Descrizione
status	InstanceViewStatus	Stato del gestore dell'estensione.
type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
typeHandlerVersion	string	Specifica la versione del gestore di script.

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza dell'estensione della macchina virtuale.

Nome	Tipo	Descrizione
name	string	Nome dell'estensione della macchina virtuale.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
substatuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
typeHandlerVersion	string	Specifica la versione del gestore di script.

VirtualMachineHealthStatus

Stato di integrità per la macchina virtuale.

Nome	Tipo	Descrizione
status	InstanceViewStatus	Informazioni sullo stato di integrità per la macchina virtuale.

VirtualMachineIdentity

Identità della macchina virtuale, se configurata.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità della macchina virtuale. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant associato alla macchina virtuale. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ResourceIdentityType	Tipo di identità usata per la macchina virtuale. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà le identità dalla macchina virtuale.
userAssignedIdentities	UserAssignedIdentities	Elenco di identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

VirtualMachineInstanceView

Visualizzazione dell'istanza della macchina virtuale.

Nome	Tipo	Descrizione
assignedHost	string	ID risorsa dell'host dedicato, in cui la macchina virtuale viene allocata tramite posizionamento automatico, quando la macchina virtuale è associata a un gruppo host dedicato con posizionamento automatico abilitato. Versione minima api: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.
computerName	string	Nome computer assegnato alla macchina virtuale.
disks	DiskInstanceView[]	Informazioni sul disco della macchina virtuale.
extensions	VirtualMachineExtensionInstanceView[]	Informazioni sulle estensioni.
hyperVGeneration	HyperVGenerationType	Specifica il tipo HyperVGeneration associato a una risorsa
isVMInStandbyPool	boolean	[Funzionalità di anteprima] Specifica se la macchina virtuale è attualmente all'interno o all'esterno del pool di standby.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Stato dell'operazione di manutenzione nella macchina virtuale.
osName	string	Sistema operativo in esecuzione nella macchina virtuale.
osVersion	string	Versione del sistema operativo in esecuzione nella macchina virtuale.
patchStatus	VirtualMachinePatchStatus	[Funzionalità di anteprima] Stato delle operazioni patch della macchina virtuale.
platformFaultDomain	integer	Specifica il dominio di errore della macchina virtuale.
platformUpdateDomain	integer	Specifica il dominio di aggiornamento della macchina virtuale.
rdpThumbPrint	string	Identificazione personale del certificato desktop remoto.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
vmAgent	VirtualMachineAgentInstanceView	Agente di macchine virtuali in esecuzione nella macchina virtuale.
vmHealth	VirtualMachineHealthStatus	Stato di integrità per la macchina virtuale.

VirtualMachineIpTag

Elenco di tag IP associati all'indirizzo IP pubblico.

Nome	Tipo	Descrizione
ipTagType	string	Tipo di tag IP. Esempio: FirstPartyUsage.
tag	string	Tag IP associato all'indirizzo IP pubblico. Esempio: SQL, Archiviazione e così via.

VirtualMachineNetworkInterfaceConfiguration

Specifica le configurazioni di rete che verranno usate per creare le risorse di rete delle macchine virtuali.

Nome	Tipo	Descrizione
name	string	Nome della configurazione dell'interfaccia di rete.
properties.auxiliaryMode	NetworkInterfaceAuxiliaryMode	Specifica se la modalità ausiliaria è abilitata per la risorsa interfaccia di rete.
properties.auxiliarySku	NetworkInterfaceAuxiliarySku	Specifica se lo SKU ausiliario è abilitato per la risorsa interfaccia di rete.
properties.deleteOption	DeleteOptions	Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata
properties.disableTcpStateTracking	boolean	Specifica se l'interfaccia di rete è disabilitata per il rilevamento dello stato TCP.
properties.dnsSettings	VirtualMachineNetworkInterfaceDnsSettingsConfiguration	Impostazioni DNS da applicare alle interfacce di rete.
properties.dscpConfiguration	SubResource
properties.enableAcceleratedNetworking	boolean	Specifica se l'interfaccia di rete è abilitata per la rete accelerata.
properties.enableFpga	boolean	Specifica se l'interfaccia di rete è abilitata per la rete FPGA.
properties.enableIPForwarding	boolean	Indica se l'inoltro IP è abilitato in questa scheda di interfaccia di rete.
properties.ipConfigurations	VirtualMachineNetworkInterfaceIPConfiguration[]	Specifica le configurazioni IP dell'interfaccia di rete.
properties.networkSecurityGroup	SubResource	Gruppo di sicurezza di rete.
properties.primary	boolean	Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

VirtualMachineNetworkInterfaceDnsSettingsConfiguration

Impostazioni DNS da applicare alle interfacce di rete.

Nome	Tipo	Descrizione
dnsServers	string[]	Elenco di indirizzi IP dei server DNS

VirtualMachineNetworkInterfaceIPConfiguration

Specifica le configurazioni IP dell'interfaccia di rete.

Nome	Tipo	Descrizione
name	string	Nome della configurazione IP.
properties.applicationGatewayBackendAddressPools	SubResource[]	Specifica una matrice di riferimenti ai pool di indirizzi back-end dei gateway applicazione. Una macchina virtuale può fare riferimento a pool di indirizzi back-end di più gateway applicazione. Più macchine virtuali non possono usare lo stesso gateway applicazione.
properties.applicationSecurityGroups	SubResource[]	Specifica una matrice di riferimenti al gruppo di sicurezza delle applicazioni.
properties.loadBalancerBackendAddressPools	SubResource[]	Specifica una matrice di riferimenti ai pool di indirizzi back-end dei servizi di bilanciamento del carico. Una macchina virtuale può fare riferimento a pool di indirizzi back-end di un servizio di bilanciamento del carico pubblico e interno. [Più macchine virtuali non possono usare lo stesso servizio di bilanciamento del carico sku basic].
properties.primary	boolean	Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.
properties.privateIPAddressVersion	IPVersions	Disponibile da Api-Version 2017-03-30 e versioni successive, indica se la specifica ipconfiguration è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.
properties.publicIPAddressConfiguration	VirtualMachinePublicIPAddressConfiguration	PublicIPAddressConfiguration.
properties.subnet	SubResource	Specifica l'identificatore della subnet.

VirtualMachinePatchStatus

[Funzionalità di anteprima] Stato delle operazioni patch della macchina virtuale.

Nome	Tipo	Descrizione
availablePatchSummary	AvailablePatchSummary	Riepilogo della patch disponibile dell'operazione di valutazione più recente per la macchina virtuale.
configurationStatuses	InstanceViewStatus[]	Stato di abilitazione della patchMode specificata
lastPatchInstallationSummary	LastPatchInstallationSummary	Riepilogo dell'installazione dell'ultima operazione di installazione per la macchina virtuale.

VirtualMachinePriorityTypes

Specifica la priorità per la macchina virtuale. Versione minima api: 2019-03-01

Nome	Tipo	Descrizione
Low	string
Regular	string
Spot	string

VirtualMachinePublicIPAddressConfiguration

PublicIPAddressConfiguration.

Nome	Tipo	Descrizione
name	string	Nome di configurazione dell'indirizzo publicIP.
properties.deleteOption	DeleteOptions	Specificare cosa accade all'indirizzo IP pubblico quando la macchina virtuale viene eliminata
properties.dnsSettings	VirtualMachinePublicIPAddressDnsSettingsConfiguration	Impostazioni DNS da applicare agli indirizzi publicIP.
properties.idleTimeoutInMinutes	integer	Timeout di inattività dell'indirizzo IP pubblico.
properties.ipTags	VirtualMachineIpTag[]	Elenco di tag IP associati all'indirizzo IP pubblico.
properties.publicIPAddressVersion	IPVersions	Disponibile da Api-Version 2019-07-01 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.
properties.publicIPAllocationMethod	PublicIPAllocationMethod	Specificare il tipo di allocazione IP pubblico
properties.publicIPPrefix	SubResource	PublicIPPrefix da cui allocare indirizzi publicIP.
sku	PublicIPAddressSku	Descrive lo SKU dell'indirizzo IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

VirtualMachinePublicIPAddressDnsSettingsConfiguration

Impostazioni DNS da applicare agli indirizzi publicIP.

Nome	Tipo	Descrizione
domainNameLabel	string	Prefisso dell'etichetta del nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generato è la concatenazione dell'etichetta del nome di dominio e dell'ID univoco del profilo di rete vm.
domainNameLabelScope	DomainNameLabelScopeTypes	Ambito dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generato è la concatenazione dell'etichetta del nome di dominio con hash con i criteri in base all'ambito dell'etichetta del nome di dominio e all'ID univoco del profilo di rete vm.

VirtualMachineSizeTypes

Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: Elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.

Nome	Tipo	Descrizione
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

Parametri forniti all'operazione Aggiorna macchina virtuale.

Nome	Tipo	Descrizione
identity	VirtualMachineIdentity	Identità della macchina virtuale, se configurata.
plan	Plan	Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del Marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nel portale di Azure individuare l'immagine del Marketplace che si vuole usare e quindi fare clic su Si vuole distribuire a livello di codice, Introduzione ->. Immettere le informazioni necessarie e quindi fare clic su Salva.
properties.additionalCapabilities	AdditionalCapabilities	Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale.
properties.applicationProfile	ApplicationProfile	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali.
properties.availabilitySet	SubResource	Specifica le informazioni sul set di disponibilità a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità. Per altre informazioni sui set di disponibilità, vedere panoramica dei set di disponibilità . Per altre informazioni sulla manutenzione pianificata di Azure, vedere manutenzione e aggiornamenti di per le macchine virtuali in Azure. Attualmente, una macchina virtuale può essere aggiunta solo al set di disponibilità in fase di creazione. Il set di disponibilità a cui viene aggiunta la macchina virtuale deve trovarsi nello stesso gruppo di risorse della risorsa del set di disponibilità. Non è possibile aggiungere una macchina virtuale esistente a un set di disponibilità. Questa proprietà non può esistere insieme a un riferimento properties non null.virtualMachineScaleSet.
properties.billingProfile	BillingProfile	Specifica i dettagli relativi alla fatturazione di una macchina virtuale spot di Azure. Versione minima api: 2019-03-01.
properties.capacityReservation	CapacityReservationProfile	Specifica informazioni sulla prenotazione di capacità usata per allocare la macchina virtuale. Versione minima api: 2021-04-01.
properties.diagnosticsProfile	DiagnosticsProfile	Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.
properties.evictionPolicy	VirtualMachineEvictionPolicyTypes	Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.
properties.extensionsTimeBudget	string	Specifica il tempo assegnato per l'avvio di tutte le estensioni. La durata deve essere compresa tra 15 minuti e 120 minuti (inclusi) e deve essere specificata in formato ISO 8601. Il valore predefinito è 90 minuti (PT1H30M). Versione minima api: 2020-06-01.
properties.hardwareProfile	HardwareProfile	Specifica le impostazioni hardware per la macchina virtuale.
properties.host	SubResource	Specifica informazioni sull'host dedicato in cui risiede la macchina virtuale. Versione minima api: 2018-10-01.
properties.hostGroup	SubResource	Specifica le informazioni sul gruppo host dedicato in cui risiede la macchina virtuale. Nota: Utente non può specificare le proprietà host e hostGroup. Versione minima api: 2020-06-01.
properties.instanceView	VirtualMachineInstanceView	Visualizzazione dell'istanza della macchina virtuale.
properties.licenseType	string	Specifica che l'immagine o il disco usato è stato concesso in licenza in locale. I valori possibili per il sistema operativo Windows Server sono: Windows_Client Windows_Server I valori possibili per il sistema operativo Linux Server sono: RHEL_BYOS (per RHEL) SLES_BYOS (per SUSE) Per altre informazioni, vedere Vantaggio Azure Hybrid Use per Windows Server Vantaggio Azure Hybrid Use per Linux Server Versione minima api: 2015-06-15
properties.networkProfile	NetworkProfile	Specifica le interfacce di rete della macchina virtuale.
properties.osProfile	OSProfile	Specifica le impostazioni del sistema operativo usate durante la creazione della macchina virtuale. Alcune impostazioni non possono essere modificate dopo il provisioning della macchina virtuale.
properties.platformFaultDomain	integer	Specifica il dominio di errore logico del set di scalabilità in cui verrà creata la macchina virtuale. Per impostazione predefinita, la macchina virtuale verrà assegnata automaticamente a un dominio di errore che mantiene al meglio il bilanciamento tra domini di errore disponibili. Questa opzione è applicabile solo se la proprietà 'virtualMachineScaleSet' di questa macchina virtuale è impostata. Il set di scalabilità di macchine virtuali a cui si fa riferimento deve avere 'platformFaultDomainCount' maggiore di 1. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. L'assegnazione del dominio di errore può essere visualizzata nella visualizzazione Istanza macchina virtuale. Api minima versione: 2020^12-01.
properties.priority	VirtualMachinePriorityTypes	Specifica la priorità per la macchina virtuale. Versione minima api: 2019-03-01
properties.provisioningState	string	Stato di provisioning, visualizzato solo nella risposta.
properties.proximityPlacementGroup	SubResource	Specifica informazioni sul gruppo di posizionamento di prossimità a cui deve essere assegnata la macchina virtuale. Versione minima api: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Specifica le configurazioni correlate all'evento pianificato Ridistribuire, riavviare e scheduledEventsAdditionalPublishingTargets per la macchina virtuale.
properties.scheduledEventsProfile	ScheduledEventsProfile	Specifica le configurazioni correlate agli eventi pianificati.
properties.securityProfile	SecurityProfile	Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.
properties.storageProfile	StorageProfile	Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.
properties.timeCreated	string	Specifica l'ora in cui è stata creata la risorsa macchina virtuale. Versione minima api: 2021-11-01.
properties.userData	string	UserData per la macchina virtuale, che deve essere codificata in base 64. Il cliente non deve passare segreti qui. Versione minima api: 2021-03-01.
properties.virtualMachineScaleSet	SubResource	Specifica informazioni sul set di scalabilità di macchine virtuali a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di scalabilità di macchine virtuali vengono allocate a nodi diversi per ottimizzare la disponibilità. Attualmente, una macchina virtuale può essere aggiunta solo al set di scalabilità di macchine virtuali in fase di creazione. Non è possibile aggiungere una macchina virtuale esistente a un set di scalabilità di macchine virtuali. Questa proprietà non può esistere insieme a un riferimento properties.availabilitySet non Null. Api minima version: 2019^03^01.
properties.vmId	string	Specifica l'ID univoco della macchina virtuale che è un identificatore a 128 bit codificato e archiviato in tutte le macchine virtuali IaaS di Azure SMBIOS e può essere letto usando i comandi BIOS della piattaforma.
tags	object	Tag delle risorse
zones	string[]	Zone della macchina virtuale.

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito usato per il disco del sistema operativo ConfidentialVM crittografato con chiave gestita dal cliente e il BLOB VMGuest.
securityEncryptionType	securityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.

VMGalleryApplication

Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali

Nome	Tipo	Descrizione
configurationReference	string	Facoltativo, specifica l'URI di un BLOB di Azure che sostituirà la configurazione predefinita per il pacchetto, se specificato
enableAutomaticUpgrade	boolean	Se impostato su true, quando è disponibile una nuova versione dell'applicazione della raccolta in PIR/SIG, verrà aggiornata automaticamente per la macchina virtuale/set di scalabilità di macchine virtuali
order	integer	Facoltativo, specifica l'ordine in cui devono essere installati i pacchetti
packageReferenceId	string	Specifica l'ID risorsa GalleryApplicationVersion nel formato /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{application}/versions/{version}
tags	string	Facoltativo, specifica un valore pass-through per un contesto più generico.
treatFailureAsDeploymentFailure	boolean	Facoltativo, se true, eventuali errori per qualsiasi operazione in VmApplication avranno esito negativo nella distribuzione

VMSizeProperties

Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altri dettagli, seguire le istruzioni riportate in di personalizzazione della macchina virtuale.

Nome	Tipo	Descrizione
vCPUsAvailable	integer	Specifica il numero di vCPU disponibili per la macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo sul valore delle vCPU disponibili per le dimensioni della macchina virtuale esposte in risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area.
vCPUsPerCore	integer	Specifica il rapporto tra vCPU e core fisici. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito è impostato sul valore di vCPUsPerCore per le dimensioni della macchina virtuale esposte in risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area. L'impostazione di questa proprietà su 1 indica anche che l'hyper-threading è disabilitato.

WindowsConfiguration

Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

Nome	Tipo	Descrizione
additionalUnattendContent	AdditionalUnattendContent[]	Specifica ulteriori informazioni in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml, che viene utilizzato dal programma di installazione di Windows.
enableAutomaticUpdates	boolean	Indica se gli aggiornamenti automatici sono abilitati per la macchina virtuale Windows. Il valore predefinito è true. Per i set di scalabilità di macchine virtuali, questa proprietà può essere aggiornata e gli aggiornamenti avranno effetto sul reprovisioning del sistema operativo.
enableVMAgentPlatformUpdates	boolean	Indica se gli aggiornamenti della piattaforma VMAgent sono abilitati per la macchina virtuale Windows.
patchSettings	PatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.
provisionVMAgent	boolean	Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nella macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, viene impostata su true per impostazione predefinita. In questo modo si garantisce che l'agente di macchine virtuali sia installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.
timeZone	string	Specifica il fuso orario della macchina virtuale. ad esempio "Ora solare pacifico". I valori possibili possono essere TimeZoneInfo.Id valore dai fusi orari restituiti da TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Specifica i listener di Gestione remota Windows. In questo modo si abilita Windows PowerShell remoto.

WindowsPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

Nome	Tipo	Descrizione
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Windows.

Nome	Tipo	Descrizione
bypassPlatformSafetyChecksOnUserSchedule	boolean	Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

WindowsVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false

AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true.

AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

Nome	Tipo	Descrizione
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

Specifica i listener di Gestione remota Windows. In questo modo si abilita Windows PowerShell remoto.

Nome	Tipo	Descrizione
listeners	WinRMListener[]	Elenco di listener di Gestione remota Windows

WinRMListener

Elenco di listener di Gestione remota Windows

Nome	Tipo	Descrizione
certificateUrl	string	Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto all'insieme di credenziali delle chiavi, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere la codifica Base64 dell'oggetto JSON seguente, codificato in UTF-8: { "data":"", "dataType":"pfx", "password":"" } Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
protocol	ProtocolTypes	Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.