Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Mettez à jour les propriétés d’un objet browserSite .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global |
Gouvernement des États-Unis L4 |
Us Government L5 (DOD) |
Chine gérée par 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation |
Autorisations avec privilèges minimum |
Autorisations privilégiées plus élevées |
| Déléguée (compte professionnel ou scolaire) |
BrowserSiteLists.ReadWrite.All |
Non disponible. |
| Déléguée (compte Microsoft personnel) |
Non prise en charge. |
Non prise en charge. |
| Application |
BrowserSiteLists.ReadWrite.All |
Non disponible. |
Requête HTTP
PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
Corps de la demande
Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.
Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.
| Propriété |
Type |
Description |
| allowRedirect |
Booléen |
Contrôle le comportement des sites redirigés. Si truela valeur est , indique que le site s’ouvre dans Internet Explorer 11 ou Microsoft Edge, même si le site fait l’objet d’une navigation dans le cadre d’une chaîne de redirection HTTP ou méta-actualisation. |
| commentaire |
String |
Commentaire pour le site. |
| compatibilityMode |
browserSiteCompatibilityMode |
Contrôle le paramètre de compatibilité utilisé pour des sites ou des domaines spécifiques. Les valeurs possibles sont default, internetExplorer8Enterprise, internetExplorer7Enterprise, internetExplorer11, internetExplorer10, internetExplorer9, internetExplorer8, internetExplorer7, internetExplorer5, unknownFutureValue. |
| mergeType |
browserSiteMergeType |
Type de fusion du site. Les valeurs possibles sont noMerge, default, unknownFutureValue. |
| targetEnvironment |
browserSiteTargetEnvironment |
Environnement cible dans lequel le site doit s’ouvrir. Les valeurs possibles sont internetExplorerMode, internetExplorer11, microsoftEdge, configurable, none, unknownFutureValue.
Avant le 15 juin 2022, l’option internetExplorer11 permettait d’ouvrir un site dans l’application de bureau Internet Explorer 11 (IE11). Après la mise hors service d’Internet Explorer 11 le 15 juin 2022, l’option internetExplorer11 n’ouvre plus de fenêtre IE11 et se comporte plutôt comme l’option internetExplorerMode . |
| webUrl |
String |
URL du site. |
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.
Exemples
Demande
L’exemple suivant illustre une demande.
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)
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content