Пространство имен: microsoft.graph.windowsUpdates
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Отмена регистрации ресурсов updatableAsset из управления обновлениями с помощью автоматического исправления Windows.
Вы также можете использовать метод unenrollAssetsById для отмены регистрации активов.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальное обслуживание |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай, обслуживаемый 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения |
Разрешения с наименьшим объемом привилегий |
Разрешения с более высоким уровнем привилегий |
| Делегированные (рабочая или учебная учетная запись) |
WindowsUpdates.ReadWrite.All |
Недоступно. |
| Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
| Приложение |
WindowsUpdates.ReadWrite.All |
Недоступно. |
Важно!
Для делегированного доступа с использованием рабочих или учебных учетных записей вошедший пользователь должен быть владельцем или членом группы либо ему должна быть назначена поддерживаемая роль Microsoft Entra или пользовательская роль, предоставляющая разрешения, необходимые для этой операции.
Администратор Intune или администратор развертывания клиентского компонента компонента Центра обновления Windows являются ролями с наименьшим объемом привилегий, поддерживаемыми для этой операции.
HTTP-запрос
POST /admin/windows/updates/updatableAssets/unenrollAssets
| Имя |
Описание |
| Авторизация |
Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации. |
| Content-Type |
application/json. Обязательно. |
Текст запроса
В тело запроса добавьте параметры в формате JSON.
В следующей таблице указаны параметры, которые можно использовать с этим действием.
| Параметр |
Тип |
Описание |
| updateCategory |
microsoft.graph.windowsUpdates.updateCategory |
Категория обновлений для автоматического исправления Windows, которым нужно управлять принудительно. Поддерживает подмножество значений для updateCategory. Допустимые значения: driver, feature, quality, unknownFutureValue. |
| assets |
Коллекция microsoft.graph.windowsUpdates.updatableAsset |
Список ресурсов updatableAsset , которые необходимо отменить в системе управления обновлениями для данной категории обновлений. |
Отклик
В случае успешного выполнения это действие возвращает код отклика 202 Accepted. В тексте ответа ничего не возвращается.
Примеры
Запрос
POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/unenrollAssets
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
// Dependencies
using Microsoft.Graph.Beta.Admin.Windows.Updates.UpdatableAssets.MicrosoftGraphWindowsUpdatesUnenrollAssets;
using Microsoft.Graph.Beta.Models.WindowsUpdates;
var requestBody = new UnenrollAssetsPostRequestBody
{
UpdateCategory = UpdateCategory.Feature,
Assets = new List<UpdatableAsset>
{
new AzureADDevice
{
OdataType = "#microsoft.graph.windowsUpdates.azureADDevice",
Id = "String (identifier)",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Admin.Windows.Updates.UpdatableAssets.MicrosoftGraphWindowsUpdatesUnenrollAssets.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
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
)
requestBody := graphadmin.NewUnenrollAssetsPostRequestBody()
updateCategory := graphmodels.STRING_UPDATECATEGORY
requestBody.SetUpdateCategory(&updateCategory)
updatableAsset := graphmodelswindowsupdates.NewAzureADDevice()
id := "String (identifier)"
updatableAsset.SetId(&id)
assets := []graphmodelswindowsupdates.UpdatableAssetable {
updatableAsset,
}
requestBody.SetAssets(assets)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Windows().Updates().UpdatableAssets().MicrosoftGraphWindowsUpdatesUnenrollAssets().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.admin.windows.updates.updatableassets.microsoftgraphwindowsupdatesunenrollassets.UnenrollAssetsPostRequestBody unenrollAssetsPostRequestBody = new com.microsoft.graph.beta.admin.windows.updates.updatableassets.microsoftgraphwindowsupdatesunenrollassets.UnenrollAssetsPostRequestBody();
unenrollAssetsPostRequestBody.setUpdateCategory(com.microsoft.graph.beta.models.windowsupdates.UpdateCategory.Feature);
LinkedList<com.microsoft.graph.beta.models.windowsupdates.UpdatableAsset> assets = new LinkedList<com.microsoft.graph.beta.models.windowsupdates.UpdatableAsset>();
com.microsoft.graph.beta.models.windowsupdates.AzureADDevice updatableAsset = new com.microsoft.graph.beta.models.windowsupdates.AzureADDevice();
updatableAsset.setOdataType("#microsoft.graph.windowsUpdates.azureADDevice");
updatableAsset.setId("String (identifier)");
assets.add(updatableAsset);
unenrollAssetsPostRequestBody.setAssets(assets);
graphClient.admin().windows().updates().updatableAssets().microsoftGraphWindowsUpdatesUnenrollAssets().post(unenrollAssetsPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const unenrollAssets = {
updateCategory: 'String',
assets: [
{
'@odata.type': '#microsoft.graph.windowsUpdates.azureADDevice',
id: 'String (identifier)'
}
]
};
await client.api('/admin/windows/updates/updatableAssets/unenrollAssets')
.version('beta')
.post(unenrollAssets);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Admin\Windows\Updates\UpdatableAssets\MicrosoftGraphWindowsUpdatesUnenrollAssets\UnenrollAssetsPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\UpdateCategory;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\UpdatableAsset;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\AzureADDevice;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new UnenrollAssetsPostRequestBody();
$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()->microsoftGraphWindowsUpdatesUnenrollAssets()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.WindowsUpdates
$params = @{
updateCategory = "String"
assets = @(
@{
"@odata.type" = "#microsoft.graph.windowsUpdates.azureADDevice"
id = "String (identifier)"
}
)
}
Invoke-MgBetaUnenrollWindowsUpdatesUpdatableAsset -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.admin.windows.updates.updatableassets.microsoft_graph_windows_updates_unenroll_assets.unenroll_assets_post_request_body import UnenrollAssetsPostRequestBody
from msgraph_beta.generated.models.update_category import UpdateCategory
from msgraph_beta.generated.models.windows_updates.updatable_asset import UpdatableAsset
from msgraph_beta.generated.models.windows_updates.azure_a_d_device import AzureADDevice
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UnenrollAssetsPostRequestBody(
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_windows_updates_unenroll_assets.post(request_body)
Отклик
HTTP/1.1 202 Accepted