名前空間: microsoft.graph.windowsUpdates
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
deploymentAudience のメンバーと除外コレクションを、同じ種類の updateableAsset リソースで更新します。
デプロイ対象ユーザーのメンバーまたは除外コレクションに azureADDevice を追加すると、まだ存在しない場合、Microsoft Entra デバイス オブジェクトが自動的に作成されます。
deploymentAudience の除外とメンバー コレクションに同じ updatableAsset が含まれる場合、デプロイはその資産には適用されません。
メソッド updateAudience を使用して 、deploymentAudience を更新することもできます。
注:
この API には、Intuneを介して作成されたデプロイに関連する既知の問題があります。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
✅ |
✅ |
❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
WindowsUpdates.ReadWrite.All |
注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
WindowsUpdates.ReadWrite.All |
注意事項なし。 |
重要
職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーは、グループの所有者またはメンバーであるか、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールが割り当てられている必要があります。
Intune管理者、またはWindows Update展開管理者は、この操作でサポートされる最小限の特権ロールです。
HTTP 要求
POST /admin/windows/updates/deployments/{deploymentId}/audience/updateAudienceById
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
| Content-Type |
application/json. 必須です。 |
要求本文
要求本文で、パラメーターの JSON 表記を指定します。
次の表に、このアクションで使用できるパラメーターを示します。
| パラメーター |
型 |
説明 |
| memberEntityType |
文字列 |
更新可能な資産の完全な種類。 使用可能な値は、 #microsoft.graph.windowsUpdates.azureADDevice、 #microsoft.graph.windowsUpdates.updatableAssetGroupです。 |
| addMembers |
String collection |
デプロイ対象ユーザーのメンバーとして追加する更新可能な資産に対応する識別子の一覧。 |
| removeMembers |
String collection |
デプロイ対象ユーザーのメンバーとして削除する更新可能な資産に対応する識別子の一覧。 |
| addExclusions |
String collection |
デプロイ対象ユーザーからの除外として追加する更新可能な資産に対応する識別子の一覧。 |
| removeExclusions |
String collection |
デプロイ対象ユーザーから除外として削除する更新可能な資産に対応する識別子の一覧。 |
応答
成功した場合、このアクションは 202 Accepted 応答コードを返します。 応答本文では何も返されません。
例
要求
POST https://graph.microsoft.com/beta/admin/windows/updates/deployments/b5171742-1742-b517-4217-17b5421717b5/audience/updateAudienceById
Content-Type: application/json
{
"memberEntityType": "String",
"addMembers": [
"String"
],
"removeMembers": [
"String"
],
"addExclusions": [
"String"
],
"removeExclusions": [
"String"
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Admin.Windows.Updates.Deployments.Item.Audience.MicrosoftGraphWindowsUpdatesUpdateAudienceById;
var requestBody = new UpdateAudienceByIdPostRequestBody
{
MemberEntityType = "String",
AddMembers = new List<string>
{
"String",
},
RemoveMembers = new List<string>
{
"String",
},
AddExclusions = new List<string>
{
"String",
},
RemoveExclusions = new List<string>
{
"String",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Admin.Windows.Updates.Deployments["{deployment-id}"].Audience.MicrosoftGraphWindowsUpdatesUpdateAudienceById.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"
//other-imports
)
requestBody := graphadmin.NewUpdateAudienceByIdPostRequestBody()
memberEntityType := "String"
requestBody.SetMemberEntityType(&memberEntityType)
addMembers := []string {
"String",
}
requestBody.SetAddMembers(addMembers)
removeMembers := []string {
"String",
}
requestBody.SetRemoveMembers(removeMembers)
addExclusions := []string {
"String",
}
requestBody.SetAddExclusions(addExclusions)
removeExclusions := []string {
"String",
}
requestBody.SetRemoveExclusions(removeExclusions)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Admin().Windows().Updates().Deployments().ByDeploymentId("deployment-id").Audience().MicrosoftGraphWindowsUpdatesUpdateAudienceById().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.deployments.item.audience.microsoftgraphwindowsupdatesupdateaudiencebyid.UpdateAudienceByIdPostRequestBody updateAudienceByIdPostRequestBody = new com.microsoft.graph.beta.admin.windows.updates.deployments.item.audience.microsoftgraphwindowsupdatesupdateaudiencebyid.UpdateAudienceByIdPostRequestBody();
updateAudienceByIdPostRequestBody.setMemberEntityType("String");
LinkedList<String> addMembers = new LinkedList<String>();
addMembers.add("String");
updateAudienceByIdPostRequestBody.setAddMembers(addMembers);
LinkedList<String> removeMembers = new LinkedList<String>();
removeMembers.add("String");
updateAudienceByIdPostRequestBody.setRemoveMembers(removeMembers);
LinkedList<String> addExclusions = new LinkedList<String>();
addExclusions.add("String");
updateAudienceByIdPostRequestBody.setAddExclusions(addExclusions);
LinkedList<String> removeExclusions = new LinkedList<String>();
removeExclusions.add("String");
updateAudienceByIdPostRequestBody.setRemoveExclusions(removeExclusions);
graphClient.admin().windows().updates().deployments().byDeploymentId("{deployment-id}").audience().microsoftGraphWindowsUpdatesUpdateAudienceById().post(updateAudienceByIdPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const updateAudienceById = {
memberEntityType: 'String',
addMembers: [
'String'
],
removeMembers: [
'String'
],
addExclusions: [
'String'
],
removeExclusions: [
'String'
]
};
await client.api('/admin/windows/updates/deployments/b5171742-1742-b517-4217-17b5421717b5/audience/updateAudienceById')
.version('beta')
.post(updateAudienceById);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Admin\Windows\Updates\Deployments\Item\Audience\MicrosoftGraphWindowsUpdatesUpdateAudienceById\UpdateAudienceByIdPostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new UpdateAudienceByIdPostRequestBody();
$requestBody->setMemberEntityType('String');
$requestBody->setAddMembers(['String', ]);
$requestBody->setRemoveMembers(['String', ]);
$requestBody->setAddExclusions(['String', ]);
$requestBody->setRemoveExclusions(['String', ]);
$graphServiceClient->admin()->windows()->updates()->deployments()->byDeploymentId('deployment-id')->audience()->microsoftGraphWindowsUpdatesUpdateAudienceById()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.WindowsUpdates
$params = @{
memberEntityType = "String"
addMembers = @(
"String"
)
removeMembers = @(
"String"
)
addExclusions = @(
"String"
)
removeExclusions = @(
"String"
)
}
Update-MgBetaWindowsUpdatesDeploymentAudienceById -DeploymentId $deploymentId -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.deployments.item.audience.microsoft_graph_windows_updates_update_audience_by_id.update_audience_by_id_post_request_body import UpdateAudienceByIdPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UpdateAudienceByIdPostRequestBody(
member_entity_type = "String",
add_members = [
"String",
],
remove_members = [
"String",
],
add_exclusions = [
"String",
],
remove_exclusions = [
"String",
],
)
await graph_client.admin.windows.updates.deployments.by_deployment_id('deployment-id').audience.microsoft_graph_windows_updates_update_audience_by_id.post(request_body)
応答
HTTP/1.1 202 Accepted