Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Erstellen Sie ein neues browserSite-Objekt in einer browserSiteList.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
BrowserSiteLists.ReadWrite.All |
Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
BrowserSiteLists.ReadWrite.All |
Nicht verfügbar. |
HTTP-Anforderung
POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des browserSite-Objekts an.
Sie können die folgenden Eigenschaften angeben, wenn Sie eine browserSite erstellen.
| Eigenschaft |
Typ |
Beschreibung |
| allowRedirect |
Boolean |
Steuert das Verhalten umgeleiteter Websites. Gibt truean, dass die Website im Internet Explorer 11 oder Microsoft Edge geöffnet wird, auch wenn die Website als Teil einer HTTP- oder Metaaktualisierungs-Umleitungskette zu der Website navigiert wird. Erforderlich. |
| Kommentar |
Zeichenfolge |
Der Kommentar für die Website. Erforderlich |
| compatibilityMode |
browserSiteCompatibilityMode |
Steuert, welche Kompatibilitätseinstellung für bestimmte Websites oder Domänen verwendet wird. Mögliche Werte sind: default, internetExplorer8Enterprise, internetExplorer7Enterprise, internetExplorer11, internetExplorer10, internetExplorer9, internetExplorer8, internetExplorer7, internetExplorer5, unknownFutureValue. Erforderlich. |
| mergeType |
browserSiteMergeType |
Der Mergetyp der Website. Die möglichen Werte sind: noMerge, default, unknownFutureValue. Erforderlich. |
| targetEnvironment |
browserSiteTargetEnvironment |
Die Zielumgebung, in der die Website geöffnet werden soll. Mögliche Werte sind: internetExplorerMode, internetExplorer11, microsoftEdge, configurable, none, unknownFutureValue. Erforderlich.
Vor dem 15. Juni 2022 ermöglichte die Option das internetExplorer11 Öffnen einer Website im Internet Explorer 11 (IE11)-Desktopanwendung. Nach der Außerbetriebnahme von IE11 am 15. Juni 2022 öffnet die internetExplorer11 Option kein IE11-Fenster mehr und verhält sich stattdessen wie die internetExplorerMode Option. |
| webUrl |
Zeichenfolge |
Die URL der Website. Erforderlich. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein browserSite-Objekt im Antworttext zurück.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sites
Content-Type: application/json
Content-length: 387
{
"@odata.type": "#microsoft.graph.browserSite",
"webUrl": "www.microsoft.com",
"targetEnvironment": "InternetExplorer11",
"comment": "A site that opens in InternetExplorer11",
"mergeType": "default",
"compatibilityMode": "default",
"allowRedirect": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new BrowserSite
{
OdataType = "#microsoft.graph.browserSite",
WebUrl = "www.microsoft.com",
TargetEnvironment = BrowserSiteTargetEnvironment.InternetExplorer11,
Comment = "A site that opens in InternetExplorer11",
MergeType = BrowserSiteMergeType.Default,
CompatibilityMode = BrowserSiteCompatibilityMode.Default,
AllowRedirect = true,
};
// 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.PostAsync(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.INTERNETEXPLORER11_BROWSERSITETARGETENVIRONMENT
requestBody.SetTargetEnvironment(&targetEnvironment)
comment := "A site that opens in InternetExplorer11"
requestBody.SetComment(&comment)
mergeType := graphmodels.DEFAULT_BROWSERSITEMERGETYPE
requestBody.SetMergeType(&mergeType)
compatibilityMode := graphmodels.DEFAULT_BROWSERSITECOMPATIBILITYMODE
requestBody.SetCompatibilityMode(&compatibilityMode)
allowRedirect := true
requestBody.SetAllowRedirect(&allowRedirect)
// 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().Post(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.setOdataType("#microsoft.graph.browserSite");
browserSite.setWebUrl("www.microsoft.com");
browserSite.setTargetEnvironment(BrowserSiteTargetEnvironment.InternetExplorer11);
browserSite.setComment("A site that opens in InternetExplorer11");
browserSite.setMergeType(BrowserSiteMergeType.Default);
browserSite.setCompatibilityMode(BrowserSiteCompatibilityMode.Default);
browserSite.setAllowRedirect(true);
BrowserSite result = graphClient.admin().edge().internetExplorerMode().siteLists().byBrowserSiteListId("{browserSiteList-id}").sites().post(browserSite);
const options = {
authProvider,
};
const client = Client.init(options);
const browserSite = {
'@odata.type': '#microsoft.graph.browserSite',
webUrl: 'www.microsoft.com',
targetEnvironment: 'InternetExplorer11',
comment: 'A site that opens in InternetExplorer11',
mergeType: 'default',
compatibilityMode: 'default',
allowRedirect: true
};
await client.api('/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sites')
.version('beta')
.post(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->setOdataType('#microsoft.graph.browserSite');
$requestBody->setWebUrl('www.microsoft.com');
$requestBody->setTargetEnvironment(new BrowserSiteTargetEnvironment('internetExplorer11'));
$requestBody->setComment('A site that opens in InternetExplorer11');
$requestBody->setMergeType(new BrowserSiteMergeType('default'));
$requestBody->setCompatibilityMode(new BrowserSiteCompatibilityMode('default'));
$requestBody->setAllowRedirect(true);
$result = $graphServiceClient->admin()->edge()->internetExplorerMode()->siteLists()->byBrowserSiteListId('browserSiteList-id')->sites()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.browserSite"
webUrl = "www.microsoft.com"
targetEnvironment = "InternetExplorer11"
comment = "A site that opens in InternetExplorer11"
mergeType = "default"
compatibilityMode = "default"
allowRedirect = $true
}
New-MgBetaAdminEdgeInternetExplorerModeSiteListSite -BrowserSiteListId $browserSiteListId -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(
odata_type = "#microsoft.graph.browserSite",
web_url = "www.microsoft.com",
target_environment = BrowserSiteTargetEnvironment.InternetExplorer11,
comment = "A site that opens in InternetExplorer11",
merge_type = BrowserSiteMergeType.Default,
compatibility_mode = BrowserSiteCompatibilityMode.Default,
allow_redirect = True,
)
result = await graph_client.admin.edge.internet_explorer_mode.site_lists.by_browser_site_list_id('browserSiteList-id').sites.post(request_body)
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-Type: application/json
{
"status": "pendingAdd",
"id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7",
"webUrl": "www.microsoft.com",
"targetEnvironment": "internetExplorer11",
"mergeType": "default",
"compatibilityMode": "default",
"allowRedirect": true,
"comment": "A site that opens in InternetExplorer11",
"lastModifiedDateTime": "2022-06-29T14:51:23.8662592Z",
"createdDateTime": "2022-06-29T14:51:23.8662595Z",
"deletedDateTime": null,
"lastModifiedBy": {
"user": {
"id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
"displayName": "Joe Smith"
},
"application": null
},
"history": []
}