Erstellen von browserSite

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

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 von umgeleiteten Websites. If truegibt an, dass die Website in Internet Explorer 11 oder Microsoft Edge geöffnet wird, auch wenn die Website im Rahmen einer HTTP- oder Metaaktualisierungs-Umleitungskette angefordert 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 Zusammenführungstyp 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 würde die internetExplorer11 Option das Öffnen einer Website in der Desktopanwendung Internet Explorer 11 (IE11) ermöglichen. Nachdem IE11 am 15. Juni 2022 eingestellt wurde, ö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 diese Methode einen 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
}

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": []
}