Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa una aplicación en la nube. Las aplicaciones en la nube se basan en opciones compartidas de primera línea y proporcionan a los usuarios finales de Windows 365 una experiencia para acceder a sesiones solo de aplicación en lugar de una experiencia de escritorio completa.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | Colección cloudPcCloudApp | Enumerar todos los objetos cloudPcCloudApp filtrados por un id. de directiva de aprovisionamiento. |
| Crear | cloudPcCloudApp | Cree un nuevo objeto cloudPcCloudApp . |
| Get | cloudPcCloudApp | Leer las propiedades de un objeto cloudPcCloudApp específico. |
| Actualizar | cloudPcCloudApp | Actualice las propiedades de un objeto cloudPcCloudApp , como el nombre para mostrar o la ruta de acceso del icono. |
| Delete | Ninguno | Eliminar un objeto cloudPcCloudApp . |
| Publicar | Ninguno | Publique un objeto cloudPcCloudApp para ponerlo a disposición de los usuarios finales a través de su portal, como Aplicación de Windows. |
| Cancelar la publicación | Ninguno | Anular la publicación de una cloudPcCloudApp para quitarla del portal de usuario final, por ejemplo, la Aplicación de Windows. |
| Reset | Ninguno | Restablezca los detalles de la aplicación del objeto cloudPcCloudApp en los detalles de la aplicación de la aplicación detectada inicialmente a la que está asignada esta aplicación en la nube. |
| Recuperar aplicaciones detectadas | cloudPcDiscoveredApp | Obtenga una lista de objetos cloudPcDiscoveredApp cuyos detalles de aplicación se pueden usar para asignar a un objeto cloudPcCloudApp . |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| actionFailedErrorCode | cloudPcCloudAppActionFailedErrorCode | El código de error si se produce un error de publicación, anulación de publicación o restablecimiento de una aplicación en la nube. Los valores posibles son: cloudAppQuotaExceeded, cloudPcLicenseNotFound, internalServerError, appDiscoveryFailed, unknownFutureValue, iconPathInvalid y filePathInvalid. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolutiva: iconPathInvalid, filePathInvalid. El valor predeterminado es null. Admite $filter, $select, $orderBy. Solo lectura. |
| actionFailedErrorMessage | Cadena | El mensaje de error cuando el administrador de TI no pudo publicar, anular la publicación, actualizar o restablecer una aplicación en la nube. Por ejemplo: "Error al publicar porque supera el límite de 500 aplicaciones en la nube de la directiva. Debe cancelar la publicación de algunas aplicaciones en la nube bajo esta directiva para volver a publicar esta aplicación en la nube". Solo lectura. |
| addedDateTime | DateTimeOffset | La fecha y hora en que se agregó la aplicación en la nube a este inquilino y se hizo visible en el portal de administración. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Se devuelve de forma predeterminada. Un administrador de TI no puede establecerlo ni modificarlo. Admite $filter, $select y $orderBy. Solo lectura. |
| appDetail | cloudPcCloudAppDetail | Los detalles sobre la aplicación en la nube. Estos valores proceden inicialmente de la propiedad appDetail de la aplicación detectada asociada. Las propiedades iconPath, iconIndex y commandLineArguments se pueden cambiar según sea necesario al actualizar la aplicación en la nube. El tipo cloudPcCloudAppDetail es polimórfico e incluye los siguientes tipos derivados: cloudPcAutomaticDiscoveredAppDetailpara las aplicaciones detectadas automáticamente desde el menú Inicio y cloudPcFilePathAppDetail para las aplicaciones creadas manualmente cuando se especifica una ruta de acceso de archivo. La propiedad @odata.type indica el tipo específico. Admite $select. |
| appStatus | cloudPcCloudAppStatus | El estado de la aplicación en la nube. Los valores posibles son: preparing, ready, publishing, published, unpublishing, failed y unknownFutureValue. El valor predeterminado es preparing. Por ejemplo, el estado es preparing cuando la aplicación en la nube aparece en el portal de Intune, lo que indica que la aplicación en la nube aún no está lista para publicarse. A continuación, el estado pasa a , lo readyque indica que la aplicación en la nube está lista para publicarse. Cuando un administrador publica o anula la publicación de una aplicación en la nube, el estado pasa a publishing or unpublishing, respectivamente, antes de pasar finalmente a published or ready. Admite $filter, $select y $orderBy. Solo lectura. |
| availableToUser | Booleano | Indica si esta aplicación en la nube está disponible para los usuarios finales a través del portal de usuario final o la Aplicación de Windows. El valor predeterminado es false. Cambia a si la aplicación en la nube se publica true correctamente y vuelve a cuando false el administrador cancela la publicación de la aplicación en la nube. Admite $filter, $select y $orderBy. |
| description | Cadena | Descripción asociada a la aplicación en la nube. La longitud máxima permitida para esta propiedad es de 512 caracteres. Admite $filter, $select y $orderBy. |
| discoveredAppName | Cadena | Nombre de la aplicación detectada asociada a la aplicación en la nube. Por ejemplo, Paint, admite $filter, $selecty $orderBy. Solo lectura. |
| displayName | Cadena | El nombre para mostrar de la aplicación en la nube. El nombre para mostrar de la aplicación en la nube, que aparece en el portal de usuario final y debe ser único dentro de una única directiva de aprovisionamiento. Usa el nombre de la aplicación detectada como valor predeterminado. La longitud máxima permitida para esta propiedad es de 64 caracteres. Por ejemplo, Paint. Admite $filter, $select y $orderBy. |
| id | Cadena | El identificador único de la aplicación en la nube. Valor generado automáticamente durante la creación de una nueva aplicación en la nube. Admite $filter, $select y $orderBy. Solo lectura. |
| lastPublishedDateTime | DateTimeOffset | La última fecha y hora en que el administrador publicó la aplicación en la nube. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Se devuelve de forma predeterminada. Un administrador de TI no puede establecerlo ni modificarlo. Admite $filter, $select y $orderBy. Solo lectura. |
| provisioningPolicyId | Cadena | El identificador de la directiva de aprovisionamiento asociada a esta aplicación en la nube. Por ejemplo, 96133506-c05b-4dbb-a150-ed4adc59895f. Admite $filter, $select y $orderBy. Obligatorio. |
| scopeIds | Colección string | Lista de identificadores de etiquetas de ámbito para esta aplicación en la nube. Heredado de la directiva de aprovisionamiento cuando se crea o actualiza la aplicación. Solo lectura. |
valores de cloudPcCloudAppStatus
| Member | Descripción |
|---|---|
| Preparación | Valor predeterminado. El estado inicial de una aplicación en la nube. Indica que la aplicación en la nube aún no está lista para publicar. |
| listo | Indica que la aplicación en la nube está lista para la publicación. |
| Publicación | Indica que la aplicación en la nube está en un estado de publicación o actualización. |
| Publicado | Indica que la aplicación se ha publicado o actualizado correctamente. |
| Anulación de publicación | Indica que la aplicación en la nube está en un estado de anulación de publicación. |
| con errores | Indica que la aplicación no pudo completar el proceso de publicación, anulación de publicación, actualización o restablecimiento. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
valores de cloudPcCloudAppActionFailedErrorCode
| Member | Descripción |
|---|---|
| cloudAppQuotaExceeded | Indica que la directiva de aprovisionamiento alcanzó el límite de 500 aplicaciones en la nube. Para continuar, anule la publicación de una aplicación en la nube existente e inténtelo de nuevo. |
| cloudPcLicenseNotFound | Indica que el inquilino no tiene ninguna licencia de primera línea disponible. |
| internalServerError | Indica que la aplicación en la nube no se puede publicar o anular la publicación debido a un error interno del servidor. |
| appDiscoveryFailed | Indica que se produjo un error en la detección de la aplicación en el dispositivo de PC en la nube asociado. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
| iconPathInvalid | Indica que la ruta de acceso del icono especificada para la aplicación en la nube no es válida. |
| filePathInvalid | Indica que la ruta de acceso del archivo especificada para la aplicación en la nube no es válida. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.cloudPcCloudApp",
"actionFailedErrorCode": "String",
"actionFailedErrorMessage": "String",
"addedDateTime": "String (timestamp)",
"appDetail": {"@odata.type": "microsoft.graph.cloudPcCloudAppDetail"},
"appStatus": "String",
"availableToUser": "Boolean",
"description": "String",
"discoveredAppName": "String",
"displayName": "String",
"id": "String (identifier)",
"lastPublishedDateTime": "String (timestamp)",
"provisioningPolicyId": "String",
"scopeIds": ["String"]
}