Atualizar windowsPhone81SCEPCertificateProfileUpdate windowsPhone81SCEPCertificateProfile

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão/beta estão sujeitas a alterações; Não há suporte para o uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Atualiza as propriedades de um objeto windowsPhone81SCEPCertificateProfile .Update the properties of a windowsPhone81SCEPCertificateProfile object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitação HTTPHTTP Request

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto windowsPhone81SCEPCertificateProfile .In the request body, supply a JSON representation for the windowsPhone81SCEPCertificateProfile object.

A tabela a seguir mostra as propriedades que são necessárias ao criar windowsPhone81SCEPCertificateProfile.The following table shows the properties that are required when you create the windowsPhone81SCEPCertificateProfile.

PropriedadeProperty TipoType DescriçãoDescription
idid StringString Chave da entidade.Key of the entity. Herdada de deviceConfigurationInherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset DateTime da última modificação do objeto.DateTime the object was last modified. Herdada de deviceConfigurationInherited from deviceConfiguration
roleScopeTagIdsroleScopeTagIds Coleção de cadeias de caracteresString collection Lista de marcas de escopo para esta instância de entidade.List of Scope Tags for this Entity instance. Herdada de deviceConfigurationInherited from deviceConfiguration
supportsScopeTagssupportsScopeTags BoolianoBoolean Indica se a configuração de dispositivo subjacente é ou não compatível com a atribuição de marcas de escopo.Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. A atribuição à propriedade ScopeTags não é permitida quando esse valor é false e as entidades não serão visíveis aos usuários com escopo.Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. Isso ocorre para políticas herdadas criadas no Silverlight e pode ser resolvido excluindo e recriando a política no portal do Azure.This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. Essa propriedade é somente leitura.This property is read-only. Herdada de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition A aplicabilidade da edição do sistema operacional para essa política.The OS edition applicability for this Policy. Herdada de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion A regra de aplicabilidade da versão do sistema operacional para esta política.The OS version applicability rule for this Policy. Herdada de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode A regra de aplicabilidade do modo de dispositivo para essa política.The device mode applicability rule for this Policy. Herdada de deviceConfigurationInherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset DateTime em que o objeto foi criado.DateTime the object was created. Herdada de deviceConfigurationInherited from deviceConfiguration
descriptiondescription StringString O administrador forneceu a descrição da Configuração do dispositivo.Admin provided description of the Device Configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
displayNamedisplayName StringString O administrador forneceu o nome da Configuração do dispositivo.Admin provided name of the device configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
versãoversion Int32Int32 Versão da configuração do dispositivo.Version of the device configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
renewalThresholdPercentagerenewalThresholdPercentage Int32Int32 Porcentagem de limite de renovação de certificado.Certificate renewal threshold percentage. Herdado de windowsPhone81CertificateProfileBaseInherited from windowsPhone81CertificateProfileBase
keyStorageProviderkeyStorageProvider keyStorageProviderOptionkeyStorageProviderOption Provedor de armazenamento de chaves (KSP).Key Storage Provider (KSP). Herdado de windowsPhone81CertificateProfileBase.Inherited from windowsPhone81CertificateProfileBase. Os valores possíveis são: useTpmKspOtherwiseUseSoftwareKsp, useTpmKspOtherwiseFail, usePassportForWorkKspOtherwiseFail, useSoftwareKsp.Possible values are: useTpmKspOtherwiseUseSoftwareKsp, useTpmKspOtherwiseFail, usePassportForWorkKspOtherwiseFail, useSoftwareKsp.
subjectNameFormatsubjectNameFormat subjectNameFormatsubjectNameFormat Formato do nome de entidade do certificado.Certificate Subject Name Format. Herdado de windowsPhone81CertificateProfileBase.Inherited from windowsPhone81CertificateProfileBase. Os valores possíveis são: commonName, commonNameIncludingEmail, commonNameAsEmail, custom, commonNameAsIMEI, commonNameAsSerialNumber, commonNameAsAadDeviceId, commonNameAsIntuneDeviceId, commonNameAsDurableDeviceId.Possible values are: commonName, commonNameIncludingEmail, commonNameAsEmail, custom, commonNameAsIMEI, commonNameAsSerialNumber, commonNameAsAadDeviceId, commonNameAsIntuneDeviceId, commonNameAsDurableDeviceId.
subjectAlternativeNameTypesubjectAlternativeNameType subjectAlternativeNameTypesubjectAlternativeNameType Tipo de nome alternativo da entidade do certificado.Certificate Subject Alternative Name Type. Herdado de windowsPhone81CertificateProfileBase.Inherited from windowsPhone81CertificateProfileBase. Os possíveis valores são: none, emailAddress, userPrincipalName, customAzureADAttribute, domainNameService, universalResourceIdentifier.Possible values are: none, emailAddress, userPrincipalName, customAzureADAttribute, domainNameService, universalResourceIdentifier.
certificateValidityPeriodValuecertificateValidityPeriodValue Int32Int32 Valor para o período de Validtiy do certificado.Value for the Certificate Validtiy Period. Herdado de windowsPhone81CertificateProfileBaseInherited from windowsPhone81CertificateProfileBase
certificateValidityPeriodScalecertificateValidityPeriodScale certificateValidityPeriodScalecertificateValidityPeriodScale Dimensionar o período de validade do certificado.Scale for the Certificate Validity Period. Herdado de windowsPhone81CertificateProfileBase.Inherited from windowsPhone81CertificateProfileBase. Os valores possíveis são: days, months, years.Possible values are: days, months, years.
extendedKeyUsagesextendedKeyUsages coleção extendedKeyUsageextendedKeyUsage collection Configurações de EKU (uso estendido de chave).Extended Key Usage (EKU) settings. Esta coleção pode conter um máximo de 500 elementos.This collection can contain a maximum of 500 elements. Herdado de windowsPhone81CertificateProfileBaseInherited from windowsPhone81CertificateProfileBase
scepServerUrlsscepServerUrls Coleção de cadeias de caracteresString collection URL (s) do servidor de SCEP.SCEP Server Url(s).
subjectNameFormatStringsubjectNameFormatString StringString Formato personalizado a ser usado com SubjectNameFormat = Custom.Custom format to use with SubjectNameFormat = Custom. Exemplo: CN = {{EmailAddress}}, E = {{EmailAddress}}, OU = usuários corporativos, O = Contoso Corporation, L = Redmond, ST = WA, C = brExample: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US
uso dekeyUsage usos dekeyUsages Uso da chave do SCEP.SCEP Key Usage. Os valores possíveis são: keyEncipherment e digitalSignature.Possible values are: keyEncipherment, digitalSignature.
keySizekeySize keySizekeySize Tamanho da chave SCEP.SCEP Key Size. Os valores possíveis são: size1024, size2048, size4096.Possible values are: size1024, size2048, size4096.
hashAlgorithmhashAlgorithm hashAlgorithmhashAlgorithms Algoritmo de hash do SCEP.SCEP Hash Algorithm. Os valores possíveis são: sha1 e sha2.Possible values are: sha1, sha2.
Subjectalternativenameformatstring foisubjectAlternativeNameFormatString StringString Cadeia de caracteres personalizada que define o atributo AAD.Custom String that defines the AAD Attribute.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e um objeto windowsPhone81SCEPCertificateProfile atualizado no corpo da resposta.If successful, this method returns a 200 OK response code and an updated windowsPhone81SCEPCertificateProfile object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1805

{
  "@odata.type": "#microsoft.graph.windowsPhone81SCEPCertificateProfile",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "renewalThresholdPercentage": 10,
  "keyStorageProvider": "useTpmKspOtherwiseFail",
  "subjectNameFormat": "commonNameIncludingEmail",
  "subjectAlternativeNameType": "emailAddress",
  "certificateValidityPeriodValue": 14,
  "certificateValidityPeriodScale": "months",
  "extendedKeyUsages": [
    {
      "@odata.type": "microsoft.graph.extendedKeyUsage",
      "name": "Name value",
      "objectIdentifier": "Object Identifier value"
    }
  ],
  "scepServerUrls": [
    "Scep Server Urls value"
  ],
  "subjectNameFormatString": "Subject Name Format String value",
  "keyUsage": "digitalSignature",
  "keySize": "size2048",
  "hashAlgorithm": "sha2",
  "subjectAlternativeNameFormatString": "Subject Alternative Name Format String value"
}

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1977

{
  "@odata.type": "#microsoft.graph.windowsPhone81SCEPCertificateProfile",
  "id": "f070e30e-e30e-f070-0ee3-70f00ee370f0",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "renewalThresholdPercentage": 10,
  "keyStorageProvider": "useTpmKspOtherwiseFail",
  "subjectNameFormat": "commonNameIncludingEmail",
  "subjectAlternativeNameType": "emailAddress",
  "certificateValidityPeriodValue": 14,
  "certificateValidityPeriodScale": "months",
  "extendedKeyUsages": [
    {
      "@odata.type": "microsoft.graph.extendedKeyUsage",
      "name": "Name value",
      "objectIdentifier": "Object Identifier value"
    }
  ],
  "scepServerUrls": [
    "Scep Server Urls value"
  ],
  "subjectNameFormatString": "Subject Name Format String value",
  "keyUsage": "digitalSignature",
  "keySize": "size2048",
  "hashAlgorithm": "sha2",
  "subjectAlternativeNameFormatString": "Subject Alternative Name Format String value"
}