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.
Tipo de permiso
Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)
Application.Read.All y Policy.Read.All, Application.Read.All y Policy.ReadWrite.ApplicationConfiguration
Delegado (cuenta personal de Microsoft)
No admitida.
Aplicación
Application.Read.All y Policy.Read.All, Application.Read.All y Policy.ReadWrite.ApplicationConfiguration
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido.
Lector global es el rol con privilegios mínimos admitido para esta operación.
Solicitud HTTP
GET /policies/appManagementPolicies/{id}/appliesTo
Parámetros de consulta opcionales
Este método admite los $selectparámetros de consulta , $filtery $top OData para ayudar a personalizar la respuesta. Puede aplicar $filter en las propiedades de los objetos application o servicePrincipal que admiten $filter. Por ejemplo, la consulta siguiente recupera el valor appId y displayName de las aplicaciones o entidades de servicio a las que se asigna la directiva.
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos application y servicePrincipal en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Obtención de aplicaciones y objetos de entidad de servicio aplicados a una directiva de administración de aplicaciones
GET https://graph.microsoft.com/v1.0/policies/appManagementPolicies/{id}/appliesTo
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.AppManagementPolicies["{appManagementPolicy-id}"].AppliesTo.GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
appliesTo, err := graphClient.Policies().AppManagementPolicies().ByAppManagementPolicyId("appManagementPolicy-id").AppliesTo().Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DirectoryObjectCollectionResponse result = graphClient.policies().appManagementPolicies().byAppManagementPolicyId("{appManagementPolicy-id}").appliesTo().get();
Ejemplo 2: Obtener propiedades específicas de aplicaciones y objetos de entidad de servicio aplicados a una directiva de administración de aplicaciones mediante $select opción de consulta
Solicitud
En el ejemplo siguiente se muestra una solicitud mediante $select opción de consulta.
GET https://graph.microsoft.com/v1.0/policies/appManagementPolicies/{id}/appliesTo?$select=id,appId,displayName,createdDateTime
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.AppManagementPolicies["{appManagementPolicy-id}"].AppliesTo.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Select = new string []{ "id","appId","displayName","createdDateTime" };
});
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphpolicies "github.com/microsoftgraph/msgraph-sdk-go/policies"
//other-imports
)
requestParameters := &graphpolicies.PoliciesAppManagementPolicieItemAppliesToRequestBuilderGetQueryParameters{
Select: [] string {"id","appId","displayName","createdDateTime"},
}
configuration := &graphpolicies.PoliciesAppManagementPolicieItemAppliesToRequestBuilderGetRequestConfiguration{
QueryParameters: requestParameters,
}
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
appliesTo, err := graphClient.Policies().AppManagementPolicies().ByAppManagementPolicyId("appManagementPolicy-id").AppliesTo().Get(context.Background(), configuration)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DirectoryObjectCollectionResponse result = graphClient.policies().appManagementPolicies().byAppManagementPolicyId("{appManagementPolicy-id}").appliesTo().get(requestConfiguration -> {
requestConfiguration.queryParameters.select = new String []{"id", "appId", "displayName", "createdDateTime"};
});
A continuación se muestra un ejemplo de la respuesta que devuelve id, appIdy createdDateTimedisplayName de las aplicaciones y entidades de servicio donde se aplica la directiva.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.