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.
Actualizar las propiedades de un objeto browserSite .
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global |
Administración pública de EE. UU. |
Gobierno de EE. UU. L5 (DOD) |
China operado por 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
BrowserSiteLists.ReadWrite.All |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
BrowserSiteLists.ReadWrite.All |
No disponible. |
Solicitud HTTP
PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.
En la tabla siguiente se especifican las propiedades que se pueden actualizar.
| Propiedad |
Tipo |
Descripción |
| allowRedirect |
Booleano |
Controla el comportamiento de los sitios redirigidos. Si true, indica que el sitio se abrirá en Internet Explorer 11 o Microsoft Edge incluso si se navega hasta el sitio como parte de una cadena de redirección HTTP o de metaactualización. |
| comentario |
Cadena |
Comentario del sitio. |
| compatibilityMode |
browserSiteCompatibilityMode |
Controla qué configuración de compatibilidad se usa para determinados sitios o dominios. Los valores posibles son: default, internetExplorer8Enterprise, internetExplorer7Enterprise, internetExplorer11, internetExplorer10, internetExplorer9, internetExplorer8, internetExplorer7, internetExplorer5 y unknownFutureValue. |
| mergeType |
browserSiteMergeType |
El tipo de combinación del sitio. Los valores posibles son: noMerge, default, unknownFutureValue. |
| targetEnvironment |
browserSiteTargetEnvironment |
El entorno de destino en el que se debe abrir el sitio. Los valores posibles son: internetExplorerMode, internetExplorer11, microsoftEdge, configurable, none, unknownFutureValue.
Antes del 15 de junio de 2022, la internetExplorer11 opción permitía abrir un sitio en la aplicación de escritorio Internet Explorer 11 (IE11). Tras la retirada de IE11 el 15 de junio de 2022, la internetExplorer11 opción ya no abrirá una ventana de IE11 y, en su lugar, se comportará igual que la internetExplorerMode opción. |
| webUrl |
Cadena |
La dirección URL del sitio. |
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/972a5778-df43-45fd-9c2a-5dd944c7a1ce/sites/7cf831d2-8a9b-4826-b120-911566f6fd6a
Content-Type: application/json
Content-length: 387
{
"webUrl": "www.microsoft.com",
"targetEnvironment": "microsoftEdge",
"mergeType": "default",
"compatibilityMode": "default",
"allowRedirect": false,
"comment": "Updating to Edge."
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new BrowserSite
{
WebUrl = "www.microsoft.com",
TargetEnvironment = BrowserSiteTargetEnvironment.MicrosoftEdge,
MergeType = BrowserSiteMergeType.Default,
CompatibilityMode = BrowserSiteCompatibilityMode.Default,
AllowRedirect = false,
Comment = "Updating to Edge.",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.Edge.InternetExplorerMode.SiteLists["{browserSiteList-id}"].Sites["{browserSite-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"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewBrowserSite()
webUrl := "www.microsoft.com"
requestBody.SetWebUrl(&webUrl)
targetEnvironment := graphmodels.MICROSOFTEDGE_BROWSERSITETARGETENVIRONMENT
requestBody.SetTargetEnvironment(&targetEnvironment)
mergeType := graphmodels.DEFAULT_BROWSERSITEMERGETYPE
requestBody.SetMergeType(&mergeType)
compatibilityMode := graphmodels.DEFAULT_BROWSERSITECOMPATIBILITYMODE
requestBody.SetCompatibilityMode(&compatibilityMode)
allowRedirect := false
requestBody.SetAllowRedirect(&allowRedirect)
comment := "Updating to Edge."
requestBody.SetComment(&comment)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sites, err := graphClient.Admin().Edge().InternetExplorerMode().SiteLists().ByBrowserSiteListId("browserSiteList-id").Sites().ByBrowserSiteId("browserSite-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);
BrowserSite browserSite = new BrowserSite();
browserSite.setWebUrl("www.microsoft.com");
browserSite.setTargetEnvironment(BrowserSiteTargetEnvironment.MicrosoftEdge);
browserSite.setMergeType(BrowserSiteMergeType.Default);
browserSite.setCompatibilityMode(BrowserSiteCompatibilityMode.Default);
browserSite.setAllowRedirect(false);
browserSite.setComment("Updating to Edge.");
BrowserSite result = graphClient.admin().edge().internetExplorerMode().siteLists().byBrowserSiteListId("{browserSiteList-id}").sites().byBrowserSiteId("{browserSite-id}").patch(browserSite);
const options = {
authProvider,
};
const client = Client.init(options);
const browserSite = {
webUrl: 'www.microsoft.com',
targetEnvironment: 'microsoftEdge',
mergeType: 'default',
compatibilityMode: 'default',
allowRedirect: false,
comment: 'Updating to Edge.'
};
await client.api('/admin/edge/internetExplorerMode/siteLists/972a5778-df43-45fd-9c2a-5dd944c7a1ce/sites/7cf831d2-8a9b-4826-b120-911566f6fd6a')
.version('beta')
.update(browserSite);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\BrowserSite;
use Microsoft\Graph\Beta\Generated\Models\BrowserSiteTargetEnvironment;
use Microsoft\Graph\Beta\Generated\Models\BrowserSiteMergeType;
use Microsoft\Graph\Beta\Generated\Models\BrowserSiteCompatibilityMode;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new BrowserSite();
$requestBody->setWebUrl('www.microsoft.com');
$requestBody->setTargetEnvironment(new BrowserSiteTargetEnvironment('microsoftEdge'));
$requestBody->setMergeType(new BrowserSiteMergeType('default'));
$requestBody->setCompatibilityMode(new BrowserSiteCompatibilityMode('default'));
$requestBody->setAllowRedirect(false);
$requestBody->setComment('Updating to Edge.');
$result = $graphServiceClient->admin()->edge()->internetExplorerMode()->siteLists()->byBrowserSiteListId('browserSiteList-id')->sites()->byBrowserSiteId('browserSite-id')->patch($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.DeviceManagement
$params = @{
webUrl = "www.microsoft.com"
targetEnvironment = "microsoftEdge"
mergeType = "default"
compatibilityMode = "default"
allowRedirect = $false
comment = "Updating to Edge."
}
Update-MgBetaAdminEdgeInternetExplorerModeSiteListSite -BrowserSiteListId $browserSiteListId -BrowserSiteId $browserSiteId -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.browser_site import BrowserSite
from msgraph_beta.generated.models.browser_site_target_environment import BrowserSiteTargetEnvironment
from msgraph_beta.generated.models.browser_site_merge_type import BrowserSiteMergeType
from msgraph_beta.generated.models.browser_site_compatibility_mode import BrowserSiteCompatibilityMode
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = BrowserSite(
web_url = "www.microsoft.com",
target_environment = BrowserSiteTargetEnvironment.MicrosoftEdge,
merge_type = BrowserSiteMergeType.Default,
compatibility_mode = BrowserSiteCompatibilityMode.Default,
allow_redirect = False,
comment = "Updating to Edge.",
)
result = await graph_client.admin.edge.internet_explorer_mode.site_lists.by_browser_site_list_id('browserSiteList-id').sites.by_browser_site_id('browserSite-id').patch(request_body)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content