名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
browserSiteList に新しい browserSite オブジェクトを作成します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
❌ |
❌ |
❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
BrowserSiteLists.ReadWrite.All |
注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
BrowserSiteLists.ReadWrite.All |
注意事項なし。 |
HTTP 要求
POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
| Content-Type |
application/json. 必須です。 |
要求本文
要求本文で、 browserSite オブジェクトの JSON 表現を指定します。
browserSite を作成するときに、次のプロパティを指定できます。
| プロパティ |
型 |
説明 |
| allowRedirect |
ブール値 |
リダイレクトされたサイトの動作を制御します。
true場合は、サイトが HTTP またはメタ更新リダイレクト チェーンの一部として に移動した場合でも、インターネット エクスプローラー 11 または Microsoft Edge でサイトが開きます。 必須です。 |
| コメント |
文字列 |
サイトのコメント。 必須 |
| compatibilityMode |
browserSiteCompatibilityMode |
特定のサイトまたはドメインに使用される互換性設定を制御します。 使用可能な値: default、internetExplorer8Enterprise、internetExplorer7Enterprise、internetExplorer11、internetExplorer10、internetExplorer9、internetExplorer8、internetExplorer7、internetExplorer5、unknownFutureValue。 必須です。 |
| mergeType |
browserSiteMergeType |
サイトのマージの種類。 使用可能な値: noMerge、default、unknownFutureValue。 必須です。 |
| targetEnvironment |
browserSiteTargetEnvironment |
サイトを開くターゲット環境。 使用可能な値: internetExplorerMode、internetExplorer11、microsoftEdge、configurable、none、unknownFutureValue。 必須です。
2022 年 6 月 15 日より前は、internetExplorer11 オプションを使用すると、インターネット エクスプローラー 11 (IE11) デスクトップ アプリケーションでサイトを開くことができるようになります。 2022 年 6 月 15 日に IE11 が廃止された後、 internetExplorer11 オプションは IE11 ウィンドウを開かなくなり、代わりに internetExplorerMode オプションと同じように動作します。 |
| webUrl |
String |
サイトの URL。 必須です。 |
応答
成功した場合、このメソッドは応答コード 201 Created と、応答本文に browserSite オブジェクトを返します。
例
要求
次の例は要求を示しています。
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)
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
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": []
}