Guest Configuration Assignments - Create Or Update

Service:

Guest Configuration

API Version:

2022-01-25

Crée une association entre une machine virtuelle et une configuration invité

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}?api-version=2022-01-25

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
guestConfigurationAssignmentName	path	True	string	Nom de l’attribution de configuration invité.
resourceGroupName	path	True	string	Nom du groupe de ressources. Regex pattern: ^[-\w\._]+$
subscriptionId	path	True	string	ID d’abonnement qui identifie de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.
vmName	path	True	string	Nom de la machine virtuelle. Regex pattern: ^[a-zA-Z0-9][-a-zA-Z0-9_.]*[a-zA-Z0-9]$
api-version	query	True	string	Version de l’API cliente.

Corps de la demande

Nom	Type	Description
location	string	Région où se trouve la machine virtuelle.
name	string	Nom de l’attribution de configuration invité.
properties	GuestConfigurationAssignmentProperties	Propriétés de l’attribution de configuration Invité.

Réponses

Nom	Type	Description
200 OK	GuestConfigurationAssignment	OK. L’attribution de configuration invité pour la machine virtuelle a été mise à jour avec succès.
201 Created	GuestConfigurationAssignment	Créé. L’attribution de configuration invité pour la machine virtuelle a été créée avec succès.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Create or update guest configuration assignment

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/NotInstalledApplicationForWindows?api-version=2022-01-25

{
  "location": "westcentralus",
  "name": "NotInstalledApplicationForWindows",
  "properties": {
    "context": "Azure policy",
    "guestConfiguration": {
      "name": "NotInstalledApplicationForWindows",
      "version": "1.0.0.3",
      "contentUri": "https://thisisfake/pacakge",
      "contentHash": "123contenthash",
      "assignmentType": "ApplyAndAutoCorrect",
      "configurationParameter": [
        {
          "name": "[InstalledApplication]NotInstalledApplicationResource1;Name",
          "value": "NotePad,sql"
        }
      ]
    }
  }
}

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.guestconfig import GuestConfigurationClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-guestconfig
# USAGE
    python create_or_update_guest_configuration_assignment.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 = GuestConfigurationClient(
        credential=DefaultAzureCredential(),
        subscription_id="mySubscriptionId",
    )

    response = client.guest_configuration_assignments.create_or_update(
        guest_configuration_assignment_name="NotInstalledApplicationForWindows",
        resource_group_name="myResourceGroupName",
        vm_name="myVMName",
        parameters={
            "location": "westcentralus",
            "name": "NotInstalledApplicationForWindows",
            "properties": {
                "context": "Azure policy",
                "guestConfiguration": {
                    "assignmentType": "ApplyAndAutoCorrect",
                    "configurationParameter": [
                        {"name": "[InstalledApplication]NotInstalledApplicationResource1;Name", "value": "NotePad,sql"}
                    ],
                    "contentHash": "123contenthash",
                    "contentUri": "https://thisisfake/pacakge",
                    "name": "NotInstalledApplicationForWindows",
                    "version": "1.*",
                },
            },
        },
    )
    print(response)


# x-ms-original-file: specification/guestconfiguration/resource-manager/Microsoft.GuestConfiguration/stable/2022-01-25/examples/createOrUpdateGuestConfigurationAssignment.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 armguestconfiguration_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/guestconfiguration/armguestconfiguration"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7a2ac91de424f271cf91cc8009f3fe9ee8249086/specification/guestconfiguration/resource-manager/Microsoft.GuestConfiguration/stable/2022-01-25/examples/createOrUpdateGuestConfigurationAssignment.json
func ExampleAssignmentsClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armguestconfiguration.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAssignmentsClient().CreateOrUpdate(ctx, "NotInstalledApplicationForWindows", "myResourceGroupName", "myVMName", armguestconfiguration.Assignment{
		Name:     to.Ptr("NotInstalledApplicationForWindows"),
		Location: to.Ptr("westcentralus"),
		Properties: &armguestconfiguration.AssignmentProperties{
			Context: to.Ptr("Azure policy"),
			GuestConfiguration: &armguestconfiguration.Navigation{
				Name:           to.Ptr("NotInstalledApplicationForWindows"),
				AssignmentType: to.Ptr(armguestconfiguration.AssignmentTypeApplyAndAutoCorrect),
				ConfigurationParameter: []*armguestconfiguration.ConfigurationParameter{
					{
						Name:  to.Ptr("[InstalledApplication]NotInstalledApplicationResource1;Name"),
						Value: to.Ptr("NotePad,sql"),
					}},
				ContentHash: to.Ptr("123contenthash"),
				ContentURI:  to.Ptr("https://thisisfake/pacakge"),
				Version:     to.Ptr("1.*"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.Assignment = armguestconfiguration.Assignment{
	// 	Name: to.Ptr("NotInstalledApplicationForWindows"),
	// 	ID: to.Ptr("/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/NotInstalledApplicationForWindows"),
	// 	Location: to.Ptr("westcentralus"),
	// 	Properties: &armguestconfiguration.AssignmentProperties{
	// 		ComplianceStatus: to.Ptr(armguestconfiguration.ComplianceStatusPending),
	// 		Context: to.Ptr("Azure policy"),
	// 		GuestConfiguration: &armguestconfiguration.Navigation{
	// 			Name: to.Ptr("NotInstalledApplicationForWindows"),
	// 			AssignmentSource: to.Ptr("AzurePolicy"),
	// 			ConfigurationParameter: []*armguestconfiguration.ConfigurationParameter{
	// 				{
	// 					Name: to.Ptr("[InstalledApplication]NotInstalledApplicationResource1;Name"),
	// 					Value: to.Ptr("NotePad,sql"),
	// 			}},
	// 			Version: to.Ptr("1.0.0.3"),
	// 		},
	// 		ProvisioningState: to.Ptr(armguestconfiguration.ProvisioningStateSucceeded),
	// 	},
	// }
}

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 { GuestConfigurationClient } = require("@azure/arm-guestconfiguration");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates an association between a VM and guest configuration
 *
 * @summary Creates an association between a VM and guest configuration
 * x-ms-original-file: specification/guestconfiguration/resource-manager/Microsoft.GuestConfiguration/stable/2022-01-25/examples/createOrUpdateGuestConfigurationAssignment.json
 */
async function createOrUpdateGuestConfigurationAssignment() {
  const subscriptionId = process.env["GUESTCONFIGURATION_SUBSCRIPTION_ID"] || "mySubscriptionId";
  const guestConfigurationAssignmentName = "NotInstalledApplicationForWindows";
  const resourceGroupName =
    process.env["GUESTCONFIGURATION_RESOURCE_GROUP"] || "myResourceGroupName";
  const vmName = "myVMName";
  const parameters = {
    name: "NotInstalledApplicationForWindows",
    location: "westcentralus",
    properties: {
      context: "Azure policy",
      guestConfiguration: {
        name: "NotInstalledApplicationForWindows",
        assignmentType: "ApplyAndAutoCorrect",
        configurationParameter: [
          {
            name: "[InstalledApplication]NotInstalledApplicationResource1;Name",
            value: "NotePad,sql",
          },
        ],
        contentHash: "123contenthash",
        contentUri: "https://thisisfake/pacakge",
        version: "1.0.0.3",
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new GuestConfigurationClient(credential, subscriptionId);
  const result = await client.guestConfigurationAssignments.createOrUpdate(
    guestConfigurationAssignmentName,
    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 System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.GuestConfiguration;
using Azure.ResourceManager.GuestConfiguration.Models;

// Generated from example definition: specification/guestconfiguration/resource-manager/Microsoft.GuestConfiguration/stable/2022-01-25/examples/createOrUpdateGuestConfigurationAssignment.json
// this example is just showing the usage of "GuestConfigurationAssignments_CreateOrUpdate" 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 GuestConfigurationVmAssignmentResource created on azure
// for more information of creating GuestConfigurationVmAssignmentResource, please refer to the document of GuestConfigurationVmAssignmentResource
string subscriptionId = "mySubscriptionId";
string resourceGroupName = "myResourceGroupName";
string vmName = "myVMName";
string guestConfigurationAssignmentName = "NotInstalledApplicationForWindows";
ResourceIdentifier guestConfigurationVmAssignmentResourceId = GuestConfigurationVmAssignmentResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName, guestConfigurationAssignmentName);
GuestConfigurationVmAssignmentResource guestConfigurationVmAssignment = client.GetGuestConfigurationVmAssignmentResource(guestConfigurationVmAssignmentResourceId);

// invoke the operation
GuestConfigurationAssignmentData data = new GuestConfigurationAssignmentData()
{
    Properties = new GuestConfigurationAssignmentProperties()
    {
        GuestConfiguration = new GuestConfigurationNavigation()
        {
            Name = "NotInstalledApplicationForWindows",
            Version = "1.*",
            ContentUri = new Uri("https://thisisfake/pacakge"),
            ContentHash = "123contenthash",
            AssignmentType = GuestConfigurationAssignmentType.ApplyAndAutoCorrect,
            ConfigurationParameters =
            {
            new GuestConfigurationParameter()
            {
            Name = "[InstalledApplication]NotInstalledApplicationResource1;Name",
            Value = "NotePad,sql",
            }
            },
        },
        Context = "Azure policy",
    },
    Name = "NotInstalledApplicationForWindows",
    Location = new AzureLocation("westcentralus"),
};
ArmOperation<GuestConfigurationVmAssignmentResource> lro = await guestConfigurationVmAssignment.UpdateAsync(WaitUntil.Completed, data);
GuestConfigurationVmAssignmentResource 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
GuestConfigurationAssignmentData 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

Sample Response

Status code:

201

{
  "location": "westcentralus",
  "id": "/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/NotInstalledApplicationForWindows",
  "name": "NotInstalledApplicationForWindows",
  "properties": {
    "complianceStatus": "Pending",
    "assignmentHash": null,
    "latestReportId": null,
    "lastComplianceStatusChecked": null,
    "context": "Azure policy",
    "resourceType": null,
    "vmssVMList": null,
    "guestConfiguration": {
      "kind": null,
      "name": "NotInstalledApplicationForWindows",
      "version": "1.0.0.3",
      "contentUri": null,
      "contentHash": null,
      "contentType": null,
      "assignmentSource": "AzurePolicy",
      "configurationParameter": [
        {
          "name": "[InstalledApplication]NotInstalledApplicationResource1;Name",
          "value": "NotePad,sql"
        }
      ]
    },
    "provisioningState": "Succeeded"
  }
}

Status code:

200

{
  "location": "westcentralus",
  "id": "/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/NotInstalledApplicationForWindows",
  "name": "NotInstalledApplicationForWindows",
  "properties": {
    "complianceStatus": "Pending",
    "assignmentHash": null,
    "latestReportId": null,
    "lastComplianceStatusChecked": null,
    "context": "Azure policy",
    "resourceType": null,
    "vmssVMList": null,
    "guestConfiguration": {
      "kind": null,
      "name": "NotInstalledApplicationForWindows",
      "version": "1.0.0.3",
      "contentUri": null,
      "contentHash": null,
      "contentType": null,
      "assignmentSource": "AzurePolicy",
      "configurationParameter": [
        {
          "name": "[InstalledApplication]NotInstalledApplicationResource1;Name",
          "value": "NotePad,sql"
        }
      ]
    },
    "provisioningState": "Succeeded"
  }
}

Définitions

Nom	Description
actionAfterReboot	Spécifie le comportement après un redémarrage survenant pendant l’application d’une configuration. Les valeurs possibles sont ContinueConfiguration et StopConfiguration
AssignmentInfo	Informations sur l’affectation de configuration d’invité.
AssignmentReport
AssignmentReportResource	Ressource d’affectation de configuration d’invité.
AssignmentReportResourceComplianceReason	Raison et code de la conformité de la ressource d’affectation de configuration invité.
assignmentType	Spécifie le type d’affectation et l’exécution de la configuration. Les valeurs possibles sont Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect et ApplyAndMonitor.
complianceStatus	Valeur indiquant la conformité status de l’ordinateur pour la configuration d’invité affectée.
ConfigurationInfo	Informations sur la configuration.
configurationMode	Spécifie comment le LCM (Local Configuration Manager) applique réellement la configuration aux nœuds cibles. Les valeurs possibles sont ApplyOnly, ApplyAndMonitor et ApplyAndAutoCorrect.
ConfigurationParameter	Représente un paramètre de configuration.
ConfigurationSetting	Paramètre de configuration de LCM (Local Configuration Manager).
createdByType	Type d’identité qui a créé la ressource.
Error
ErrorResponse	Réponse d’erreur d’un échec d’opération
GuestConfigurationAssignment	L’affectation de configuration d’invité est une association entre une configuration de machine et une configuration invité.
GuestConfigurationAssignmentProperties	Propriétés d’affectation de configuration d’invité.
GuestConfigurationNavigation	La configuration d’invité est un artefact qui encapsule la configuration DSC et ses dépendances. L’artefact est un fichier zip contenant une configuration DSC (en tant que MOF) et des ressources dépendantes et d’autres dépendances telles que des modules.
kind	Type de configuration de l’invité. Par exemple :DSC
provisioningState	État d’approvisionnement, qui apparaît uniquement dans la réponse.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
type	Type de rapport, Cohérence ou Initial
VMInfo	Informations sur la machine virtuelle.
VMSSVMInfo	Informations sur la machine virtuelle VMSS

actionAfterReboot

Spécifie le comportement après un redémarrage survenant pendant l’application d’une configuration. Les valeurs possibles sont ContinueConfiguration et StopConfiguration

Nom	Type	Description
ContinueConfiguration	string
StopConfiguration	string

AssignmentInfo

Informations sur l’affectation de configuration d’invité.

Nom	Type	Description
configuration	ConfigurationInfo	Informations sur la configuration.
name	string	Nom de l’affectation de configuration d’invité.

AssignmentReport

Nom	Type	Description
assignment	AssignmentInfo	Détails de configuration de l’affectation de configuration invité.
complianceStatus	complianceStatus	Valeur indiquant la conformité status de l’ordinateur pour la configuration d’invité affectée.
endTime	string	Date et heure de fin de l’status case activée de conformité de l’affectation de configuration d’invité.
id	string	ID de ressource ARM du rapport pour l’affectation de configuration d’invité.
operationType	type	Type de rapport, Cohérence ou Initial
reportId	string	GUID qui identifie le rapport d’affectation de configuration d’invité sous un abonnement, un groupe de ressources.
resources	AssignmentReportResource[]	Liste des ressources pour lesquelles la conformité de l’affectation de configuration d’invité est vérifiée.
startTime	string	Date et heure de début de l’status case activée de conformité de l’affectation de configuration d’invité.
vm	VMInfo	Informations sur la machine virtuelle.

AssignmentReportResource

Ressource d’affectation de configuration d’invité.

Nom	Type	Description
complianceStatus	complianceStatus	Valeur indiquant la conformité status de l’ordinateur pour la configuration d’invité affectée.
properties	object	Propriétés d’une ressource d’affectation de configuration d’invité.
reasons	AssignmentReportResourceComplianceReason[]	Raison de conformité et code de raison d’une ressource.
resourceId	string	Nom du paramètre de ressource d’affectation de configuration d’invité.

AssignmentReportResourceComplianceReason

Raison et code de la conformité de la ressource d’affectation de configuration invité.

Nom	Type	Description
code	string	Code pour la conformité de la ressource d’affectation de configuration invité.
phrase	string	Raison de la conformité de la ressource d’affectation de configuration invité.

assignmentType

Spécifie le type d’affectation et l’exécution de la configuration. Les valeurs possibles sont Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect et ApplyAndMonitor.

Nom	Type	Description
ApplyAndAutoCorrect	string
ApplyAndMonitor	string
Audit	string
DeployAndAutoCorrect	string

complianceStatus

Valeur indiquant la conformité status de l’ordinateur pour la configuration d’invité affectée.

Nom	Type	Description
Compliant	string
NonCompliant	string
Pending	string

ConfigurationInfo

Informations sur la configuration.

Nom	Type	Description
name	string	Nom de la configuration.
version	string	Version de la configuration.

configurationMode

Spécifie comment le LCM (Local Configuration Manager) applique réellement la configuration aux nœuds cibles. Les valeurs possibles sont ApplyOnly, ApplyAndMonitor et ApplyAndAutoCorrect.

Nom	Type	Description
ApplyAndAutoCorrect	string
ApplyAndMonitor	string
ApplyOnly	string

ConfigurationParameter

Représente un paramètre de configuration.

Nom	Type	Description
name	string	Nom du paramètre de configuration.
value	string	Valeur du paramètre de configuration.

ConfigurationSetting

Paramètre de configuration de LCM (Local Configuration Manager).

Nom	Type	Valeur par défaut	Description
actionAfterReboot	actionAfterReboot		Spécifie le comportement après un redémarrage survenant pendant l’application d’une configuration. Les valeurs possibles sont ContinueConfiguration et StopConfiguration
allowModuleOverwrite	boolean		Si la valeur est true, les nouvelles configurations téléchargées à partir du service d’extraction sont autorisées à remplacer les anciennes configurations sur le nœud cible. Sinon, false
configurationMode	configurationMode		Spécifie comment le LCM (Local Configuration Manager) applique réellement la configuration aux nœuds cibles. Les valeurs possibles sont ApplyOnly, ApplyAndMonitor et ApplyAndAutoCorrect.
configurationModeFrequencyMins	number	15	Fréquence, en minutes, à laquelle la configuration actuelle est vérifiée et appliquée. Cette propriété est ignorée si la propriété ConfigurationMode est définie sur ApplyOnly. La valeur par défaut est 15.
rebootIfNeeded	boolean		Définissez cette valeur sur true pour redémarrer automatiquement le nœud après l’application d’une configuration qui nécessite un redémarrage. Sinon, vous devez redémarrer manuellement le nœud. La valeur par défaut est false. Pour utiliser ce paramètre lorsqu’une condition de redémarrage est imposée par autre chose que DSC (par exemple Windows Installer), combinez ce paramètre avec le module xPendingReboot.
refreshFrequencyMins	number	30	L’intervalle de temps, en minutes, auquel le LCM contrôle un service d’extraction pour obtenir des configurations mises à jour. Cette valeur est ignorée si le LCM n’est pas configuré en mode d’extraction. La valeur par défaut est 30.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Error

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur détaillé indiquant la raison de l’échec de l’opération.

ErrorResponse

Réponse d’erreur d’un échec d’opération

Nom	Type	Description
error	Error

GuestConfigurationAssignment

L’affectation de configuration d’invité est une association entre une configuration de machine et une configuration invité.

Nom	Type	Description
id	string	ID de ressource ARM de l’affectation de configuration d’invité.
location	string	Région où se trouve la machine virtuelle.
name	string	Nom de l’affectation de configuration d’invité.
properties	GuestConfigurationAssignmentProperties	Propriétés de l’affectation de configuration invité.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource.

GuestConfigurationAssignmentProperties

Propriétés d’affectation de configuration d’invité.

Nom	Type	Description
assignmentHash	string	Hachage combiné du package de configuration et des paramètres.
complianceStatus	complianceStatus	Valeur indiquant la conformité status de l’ordinateur pour la configuration d’invité affectée.
context	string	Source qui a lancé l’affectation de configuration d’invité. Exemple : Azure Policy
guestConfiguration	GuestConfigurationNavigation	Configuration d’invité à affecter.
lastComplianceStatusChecked	string	Date et heure de la dernière vérification de la status de conformité.
latestAssignmentReport	AssignmentReport	Dernier rapport d’affectation de configuration d’invité signalé.
latestReportId	string	ID du dernier rapport pour l’affectation de configuration d’invité.
parameterHash	string	hachage de paramètre pour l’affectation de configuration d’invité.
provisioningState	provisioningState	État d’approvisionnement, qui apparaît uniquement dans la réponse.
resourceType	string	Type de la ressource - VMSS / machine virtuelle
targetResourceId	string	ID de ressource de machine virtuelle.
vmssVMList	VMSSVMInfo[]	Liste des données de conformité des machines virtuelles pour VMSS

GuestConfigurationNavigation

La configuration d’invité est un artefact qui encapsule la configuration DSC et ses dépendances. L’artefact est un fichier zip contenant une configuration DSC (en tant que MOF) et des ressources dépendantes et d’autres dépendances telles que des modules.

Nom	Type	Description
assignmentSource	string	Spécifie l’origine de la configuration.
assignmentType	assignmentType	Spécifie le type d’affectation et l’exécution de la configuration. Les valeurs possibles sont Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect et ApplyAndMonitor.
configurationParameter	ConfigurationParameter[]	Paramètres de configuration de la configuration invité.
configurationProtectedParameter	ConfigurationParameter[]	Paramètres de configuration protégés pour la configuration invité.
configurationSetting	ConfigurationSetting	Paramètre de configuration de la configuration invité.
contentHash	string	Hachage combiné du package de configuration invité et des paramètres de configuration.
contentType	string	Spécifie le type de contenu de la configuration. Les valeurs possibles peuvent être Builtin ou Custom.
contentUri	string	URI du stockage où le package de configuration invité est chargé.
kind	kind	Type de configuration de l’invité. Par exemple :DSC
name	string	Nom de la configuration de l’invité.
version	string	Version de la configuration invité.

kind

Type de configuration de l’invité. Par exemple :DSC

Nom	Type	Description
DSC	string

provisioningState

État d’approvisionnement, qui apparaît uniquement dans la réponse.

Nom	Type	Description
Canceled	string
Created	string
Failed	string
Succeeded	string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

type

Type de rapport, Cohérence ou Initial

Nom	Type	Description
Consistency	string
Initial	string

VMInfo

Informations sur la machine virtuelle.

Nom	Type	Description
id	string	ID de ressource Azure de la machine virtuelle.
uuid	string	UUID(Universally Unique Identifier) de la machine virtuelle.

VMSSVMInfo

Informations sur la machine virtuelle VMSS

Nom	Type	Description
complianceStatus	complianceStatus	Valeur indiquant la conformité status de l’ordinateur pour la configuration d’invité affectée.
lastComplianceChecked	string	Date et heure de la dernière vérification de la status de conformité.
latestReportId	string	ID du dernier rapport pour l’affectation de configuration d’invité.
vmId	string	UUID de la machine virtuelle.
vmResourceId	string	ID de ressource Azure de la machine virtuelle.