Actualizar iosImportedPFXCertificateProfileUpdate iosImportedPFXCertificateProfile

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante: Las API de Microsoft Graph en la versión/beta están sujetas a cambios; no se admite el uso de producción.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Actualice las propiedades de un objeto iosImportedPFXCertificateProfile .Update the properties of a iosImportedPFXCertificateProfile object.

Requisitos previosPrerequisites

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
ApplicationApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitud HTTPHTTP Request

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

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto iosImportedPFXCertificateProfile .In the request body, supply a JSON representation for the iosImportedPFXCertificateProfile object.

En la tabla siguiente se muestran las propiedades necesarias para crear el iosImportedPFXCertificateProfile.The following table shows the properties that are required when you create the iosImportedPFXCertificateProfile.

PropiedadProperty TipoType DescripciónDescription
idid StringString Clave de la entidad.Key of the entity. Heredado de deviceConfigurationInherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Fecha y hora en la que se modificó el objeto por última vez.DateTime the object was last modified. Heredado de deviceConfigurationInherited from deviceConfiguration
roleScopeTagIdsroleScopeTagIds Colección stringString collection Lista de etiquetas de ámbito para esta instancia de entidad.List of Scope Tags for this Entity instance. Heredado de deviceConfigurationInherited from deviceConfiguration
supportsScopeTagssupportsScopeTags BooleanBoolean Indica si la configuración de dispositivo subyacente admite la asignación de etiquetas de ámbito.Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. No se permite asignar a la propiedad ScopeTags cuando este valor es false y las entidades no serán visibles para los usuarios con ámbito.Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. Esto ocurre con las directivas heredadas creadas en Silverlight y se pueden resolver eliminando y volviendo a crear la Directiva en Azure portal.This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. Esta propiedad es de sólo lectura.This property is read-only. Heredado de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition Aplicabilidad de la edición del sistema operativo para esta Directiva.The OS edition applicability for this Policy. Heredado de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion Regla de aplicabilidad de la versión del sistema operativo para esta Directiva.The OS version applicability rule for this Policy. Heredado de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode La regla de aplicabilidad del modo de dispositivo para esta Directiva.The device mode applicability rule for this Policy. Heredado de deviceConfigurationInherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Fecha y hora en la que se creó el objeto.DateTime the object was created. Heredado de deviceConfigurationInherited from deviceConfiguration
descriptiondescription StringString Descripción proporcionada por el administrador de la configuración del dispositivo.Admin provided description of the Device Configuration. Heredado de deviceConfigurationInherited from deviceConfiguration
displayNamedisplayName CadenaString Nombre proporcionado por el administrador de la configuración del dispositivo.Admin provided name of the device configuration. Heredado de deviceConfigurationInherited from deviceConfiguration
versionversion Int32Int32 Versión de la configuración del dispositivo.Version of the device configuration. Heredado de deviceConfigurationInherited from deviceConfiguration
intendedPurposeintendedPurpose intendedPurposeintendedPurpose Propósito previsto del perfil de certificado, que podría no estar asignado, SmimeEncryption, SmimeSigning, etc. Los valores posibles son unassigned: smimeEncryption, smimeSigning, vpn, wifiy.Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: unassigned, smimeEncryption, smimeSigning, vpn, wifi.

RespuestaResponse

Si se ejecuta correctamente, este método 200 OK devuelve un código de respuesta y un objeto iosImportedPFXCertificateProfile actualizado en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and an updated iosImportedPFXCertificateProfile object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

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

{
  "@odata.type": "#microsoft.graph.iosImportedPFXCertificateProfile",
  "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,
  "intendedPurpose": "smimeEncryption"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada 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: 1248

{
  "@odata.type": "#microsoft.graph.iosImportedPFXCertificateProfile",
  "id": "583b9d8c-9d8c-583b-8c9d-3b588c9d3b58",
  "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,
  "intendedPurpose": "smimeEncryption"
}