Namespace: microsoft.graph.windowsUpdates
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Atualizar as propriedades de um objeto de política .
Você pode usar esse método com o seguinte tipo de objeto filho: qualityUpdatePolicy.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global |
Governo dos EUA L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
WindowsUpdates.ReadWrite.All |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
WindowsUpdates.ReadWrite.All |
Indisponível. |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve ser proprietário ou membro do grupo ou ser atribuído a uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação.
O Administrador do Intune ou o Administrador de Implantação do Windows Update são as funções com menos privilégios com suporte para esta operação.
Solicitação HTTP
PATCH /admin/windows/updates/policies/{policyId}
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
| Propriedade |
Tipo |
Descrição |
| approvalRules |
coleção microsoft.graph.windowsUpdates.approvalRule |
A regra aprovada da política que determina qual conteúdo publicado corresponde à regra continuamente. Opcional. |
| description |
Cadeia de caracteres |
A descrição da política de atualização de qualidade. O comprimento máximo é de 1.500 caracteres. Opcional. |
| displayName |
Cadeia de caracteres |
O nome de exibição da política de atualização de qualidade. O comprimento máximo é de 200 caracteres. Opcional. |
Resposta
Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto microsoft.graph.windowsUpdates.policy atualizado no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra como atualizar uma política de atualização de qualidade.
PATCH https://graph.microsoft.com/beta/admin/windows/updates/policies/f316bfd9-c84e-a334-cebe-071d3c64b2c1
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdatePolicy",
"displayName": "Patch Tuesday Test",
"description": "Quality update policy to test upcoming Patch Tuesday updates",
"approvalRules": [
{
"@odata.type": "microsoft.graph.windowsUpdates.qualityUpdateApprovalRule",
"deferralInDays": 0,
"classification": "nonSecurity",
"cadence": "outOfBand"
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models.WindowsUpdates;
var requestBody = new QualityUpdatePolicy
{
OdataType = "#microsoft.graph.windowsUpdates.qualityUpdatePolicy",
DisplayName = "Patch Tuesday Test",
Description = "Quality update policy to test upcoming Patch Tuesday updates",
ApprovalRules = new List<ApprovalRule>
{
new QualityUpdateApprovalRule
{
OdataType = "microsoft.graph.windowsUpdates.qualityUpdateApprovalRule",
DeferralInDays = 0,
Classification = QualityUpdateClassification.NonSecurity,
Cadence = QualityUpdateCadence.OutOfBand,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.Windows.Updates.Policies["{policy-id}"].PatchAsync(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"
graphmodelswindowsupdates "github.com/microsoftgraph/msgraph-beta-sdk-go/models/windowsupdates"
//other-imports
)
requestBody := graphmodelswindowsupdates.NewPolicy()
displayName := "Patch Tuesday Test"
requestBody.SetDisplayName(&displayName)
description := "Quality update policy to test upcoming Patch Tuesday updates"
requestBody.SetDescription(&description)
approvalRule := graphmodelswindowsupdates.NewQualityUpdateApprovalRule()
deferralInDays := int32(0)
approvalRule.SetDeferralInDays(&deferralInDays)
classification := graphmodels.NONSECURITY_QUALITYUPDATECLASSIFICATION
approvalRule.SetClassification(&classification)
cadence := graphmodels.OUTOFBAND_QUALITYUPDATECADENCE
approvalRule.SetCadence(&cadence)
approvalRules := []graphmodelswindowsupdates.ApprovalRuleable {
approvalRule,
}
requestBody.SetApprovalRules(approvalRules)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
policies, err := graphClient.Admin().Windows().Updates().Policies().ByPolicyId("policy-id").Patch(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.models.windowsupdates.QualityUpdatePolicy policy = new com.microsoft.graph.beta.models.windowsupdates.QualityUpdatePolicy();
policy.setOdataType("#microsoft.graph.windowsUpdates.qualityUpdatePolicy");
policy.setDisplayName("Patch Tuesday Test");
policy.setDescription("Quality update policy to test upcoming Patch Tuesday updates");
LinkedList<com.microsoft.graph.beta.models.windowsupdates.ApprovalRule> approvalRules = new LinkedList<com.microsoft.graph.beta.models.windowsupdates.ApprovalRule>();
com.microsoft.graph.beta.models.windowsupdates.QualityUpdateApprovalRule approvalRule = new com.microsoft.graph.beta.models.windowsupdates.QualityUpdateApprovalRule();
approvalRule.setOdataType("microsoft.graph.windowsUpdates.qualityUpdateApprovalRule");
approvalRule.setDeferralInDays(0);
approvalRule.setClassification(com.microsoft.graph.beta.models.windowsupdates.QualityUpdateClassification.NonSecurity);
approvalRule.setCadence(com.microsoft.graph.beta.models.windowsupdates.QualityUpdateCadence.OutOfBand);
approvalRules.add(approvalRule);
policy.setApprovalRules(approvalRules);
com.microsoft.graph.models.windowsupdates.Policy result = graphClient.admin().windows().updates().policies().byPolicyId("{policy-id}").patch(policy);
const options = {
authProvider,
};
const client = Client.init(options);
const policy = {
'@odata.type': '#microsoft.graph.windowsUpdates.qualityUpdatePolicy',
displayName: 'Patch Tuesday Test',
description: 'Quality update policy to test upcoming Patch Tuesday updates',
approvalRules: [
{
'@odata.type': 'microsoft.graph.windowsUpdates.qualityUpdateApprovalRule',
deferralInDays: 0,
classification: 'nonSecurity',
cadence: 'outOfBand'
}
]
};
await client.api('/admin/windows/updates/policies/f316bfd9-c84e-a334-cebe-071d3c64b2c1')
.version('beta')
.update(policy);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\QualityUpdatePolicy;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\ApprovalRule;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\QualityUpdateApprovalRule;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\QualityUpdateClassification;
use Microsoft\Graph\Beta\Generated\Models\WindowsUpdates\QualityUpdateCadence;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new QualityUpdatePolicy();
$requestBody->setOdataType('#microsoft.graph.windowsUpdates.qualityUpdatePolicy');
$requestBody->setDisplayName('Patch Tuesday Test');
$requestBody->setDescription('Quality update policy to test upcoming Patch Tuesday updates');
$approvalRulesApprovalRule1 = new QualityUpdateApprovalRule();
$approvalRulesApprovalRule1->setOdataType('microsoft.graph.windowsUpdates.qualityUpdateApprovalRule');
$approvalRulesApprovalRule1->setDeferralInDays(0);
$approvalRulesApprovalRule1->setClassification(new QualityUpdateClassification('nonSecurity'));
$approvalRulesApprovalRule1->setCadence(new QualityUpdateCadence('outOfBand'));
$approvalRulesArray []= $approvalRulesApprovalRule1;
$requestBody->setApprovalRules($approvalRulesArray);
$result = $graphServiceClient->admin()->windows()->updates()->policies()->byPolicyId('policy-id')->patch($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.WindowsUpdates
$params = @{
"@odata.type" = "#microsoft.graph.windowsUpdates.qualityUpdatePolicy"
displayName = "Patch Tuesday Test"
description = "Quality update policy to test upcoming Patch Tuesday updates"
approvalRules = @(
@{
"@odata.type" = "microsoft.graph.windowsUpdates.qualityUpdateApprovalRule"
deferralInDays = 0
classification = "nonSecurity"
cadence = "outOfBand"
}
)
}
Update-MgBetaWindowsUpdatesPolicy -PolicyId $policyId -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.models.windows_updates.quality_update_policy import QualityUpdatePolicy
from msgraph_beta.generated.models.windows_updates.approval_rule import ApprovalRule
from msgraph_beta.generated.models.windows_updates.quality_update_approval_rule import QualityUpdateApprovalRule
from msgraph_beta.generated.models.quality_update_classification import QualityUpdateClassification
from msgraph_beta.generated.models.quality_update_cadence import QualityUpdateCadence
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = QualityUpdatePolicy(
odata_type = "#microsoft.graph.windowsUpdates.qualityUpdatePolicy",
display_name = "Patch Tuesday Test",
description = "Quality update policy to test upcoming Patch Tuesday updates",
approval_rules = [
QualityUpdateApprovalRule(
odata_type = "microsoft.graph.windowsUpdates.qualityUpdateApprovalRule",
deferral_in_days = 0,
classification = QualityUpdateClassification.NonSecurity,
cadence = QualityUpdateCadence.OutOfBand,
),
],
)
result = await graph_client.admin.windows.updates.policies.by_policy_id('policy-id').patch(request_body)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdatePolicy",
"displayName": "Patch Tuesday Test",
"description": "Quality update policy to test upcoming Patch Tuesday updates",
"approvalRules": [
{
"@odata.type": "microsoft.graph.windowsUpdates.qualityUpdateApprovalRule",
"deferralInDays": 0,
"classification": "nonSecurity",
"cadence": "outOfBand"
}
],
"id": "f316bfd9-c84e-a334-cebe-071d3c64b2c1",
"createdDateTime": "2020-06-09T10:00:00Z",
"lastModifiedDateTime": "2020-06-09T10:00:00Z"
}