updatableAsset : enrollAssets

Article
08/23/2023

Espace de noms : microsoft.graph.windowsUpdates

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Inscrivez des ressources updatableAsset dans update management par le service de déploiement.

Vous pouvez inscrire une ressource azureADDevice dans Update Management, mais pas un updatableAssetGroup dans Update Management.

L’inscription d’un appareil Azure AD dans Update Management crée automatiquement un objet azureADDevice s’il n’existe pas déjà.

Vous pouvez également utiliser la méthode enrollAssetsById pour inscrire des ressources.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	WindowsUpdates.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	WindowsUpdates.ReadWrite.All

Requête HTTP

POST /admin/windows/updates/updatableAssets/enrollAssets

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant indique les paramètres utilisables avec cette action.

Paramètre	Type	Description
updateCategory	microsoft.graph.windowsUpdates.updateCategory	Catégorie de mises à jour pour le service à gérer. Prend en charge un sous-ensemble des valeurs pour updateCategory. Les valeurs possibles sont les suivantes : `driver`, `feature`, `quality`, `unknownFutureValue`.
assets	collection microsoft.graph.windowsUpdates.updatableAsset	Liste des ressources updatableAsset à inscrire dans la gestion des mises à jour par le service pour la updateCategory donnée.

Réponse

Si elle réussit, cette action renvoie un code de réponse 202 Accepted. Elle ne renvoie rien dans le corps de la réponse.

Exemples

Demande

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets
Content-Type: application/json

{
  "updateCategory": "String",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}


// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var requestBody = new Microsoft.Graph.Beta.Admin.Windows.Updates.UpdatableAssets.MicrosoftGraphWindowsUpdatesEnrollAssets.EnrollAssetsPostRequestBody
{
	UpdateCategory = Microsoft.Graph.Beta.Models.WindowsUpdates.UpdateCategory.Feature,
	Assets = new List<Microsoft.Graph.Beta.Models.WindowsUpdates.UpdatableAsset>
	{
		new Microsoft.Graph.Beta.Models.WindowsUpdates.AzureADDevice
		{
			OdataType = "#microsoft.graph.windowsUpdates.azureADDevice",
			Id = "String (identifier)",
		},
	},
};
await graphClient.Admin.Windows.Updates.UpdatableAssets.MicrosoftGraphWindowsUpdatesEnrollAssets.PostAsync(requestBody);

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta admin windows updates updatable-assets microsoft-graph-windows-updates-enroll-assets post --body '{\
  "updateCategory": "String",\
  "assets": [\
    {\
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",\
      "id": "String (identifier)"\
    }\
  ]\
}\
'

Importante



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphadmin "github.com/microsoftgraph/msgraph-beta-sdk-go/admin"
	  graphmodelswindowsupdates "github.com/microsoftgraph/msgraph-beta-sdk-go/models/windowsupdates"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphadmin.NewEnrollAssetsPostRequestBody()
updateCategory := graphmodels.STRING_UPDATECATEGORY 
requestBody.SetUpdateCategory(&updateCategory) 


updatableAsset := graphmodelswindowsupdates.NewAzureADDevice()
id := "String (identifier)"
updatableAsset.SetId(&id) 

assets := []graphmodelswindowsupdates.updatableAssetable {
	updatableAsset,
}
requestBody.SetAssets(assets)

graphClient.Admin().Windows().Updates().UpdatableAssets().MicrosoftGraphWindowsUpdatesEnrollAssets().Post(context.Background(), requestBody, nil)

Importante


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

UpdateCategory updateCategory = UpdateCategory.FEATURE;

LinkedList<UpdatableAsset> assetsList = new LinkedList<UpdatableAsset>();
AzureADDevice assets = new AzureADDevice();
assets.id = "String (identifier)";

assetsList.add(assets);
UpdatableAssetCollectionResponse updatableAssetCollectionResponse = new UpdatableAssetCollectionResponse();
updatableAssetCollectionResponse.value = assetsList;
UpdatableAssetCollectionPage updatableAssetCollectionPage = new UpdatableAssetCollectionPage(updatableAssetCollectionResponse, null);

graphClient.admin().windows().updates().updatableAssets()
	.enrollAssets(UpdatableAssetEnrollAssetsParameterSet
		.newBuilder()
		.withUpdateCategory(updateCategory)
		.withAssets(assetsList)
		.build())
	.buildRequest()
	.post();

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

const enrollAssets = {
  updateCategory: 'String',
  assets: [
    {
      '@odata.type': '#microsoft.graph.windowsUpdates.azureADDevice',
      id: 'String (identifier)'
    }
  ]
};

await client.api('/admin/windows/updates/updatableAssets/enrollAssets')
	.version('beta')
	.post(enrollAssets);

Importante


<?php

// THIS SNIPPET IS A PREVIEW VERSION OF THE SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new EnrollAssetsPostRequestBody();
$requestBody->setUpdateCategory(new UpdateCategory('string'));
$assetsUpdatableAsset1 = new AzureADDevice();
$assetsUpdatableAsset1->setOdataType('#microsoft.graph.windowsUpdates.azureADDevice');
$assetsUpdatableAsset1->setId('String (identifier)');
$assetsArray []= $assetsUpdatableAsset1;
$requestBody->setAssets($assetsArray);


$graphServiceClient->admin()->windows()->updates()->updatableAssets()->microsoftGraphWindowsUpdatesEnrollAssets()->post($requestBody)->wait();

Importante


Import-Module Microsoft.Graph.Beta.WindowsUpdates

$params = @{
	updateCategory = "String"
	assets = @(
		@{
			"@odata.type" = "#microsoft.graph.windowsUpdates.azureADDevice"
			id = "String (identifier)"
		}
	)
}

Invoke-MgBetaEnrollWindowsUpdatesUpdatableAsset -BodyParameter $params

Importante


# THE PYTHON SDK IS IN PREVIEW. FOR NON-PRODUCTION USE ONLY

graph_client = GraphServiceClient(request_adapter)

request_body = EnrollAssetsPostRequestBody(
	update_category = UpdateCategory.Feature,
	assets = [
		AzureADDevice(
			odata_type = "#microsoft.graph.windowsUpdates.azureADDevice",
			id = "String (identifier)",
		),
	]
)

await graph_client.admin.windows.updates.updatable_assets.microsoft_graph_window_update_enroll_assets.post(body = request_body)

Importante

Réponse

HTTP/1.1 202 Accepted

updatableAsset : enrollAssets

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Ressources supplémentaires

Ressources supplémentaires