intuneBrandingProfile を作成する

[アーティクル]
08/02/2024

名前空間: microsoft.graph

大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	DeviceManagementApps.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementApps.ReadWrite.All

HTTP 要求

POST /deviceManagement/intuneBrandingProfiles

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。必須です。認証と認可についての詳細をご覧ください。
承諾	application/json

要求本文

要求本文で、intuneBrandingProfile オブジェクトの JSON 表現を指定します。

次の表は、intuneBrandingProfile を作成するときに必要なプロパティを示しています。

プロパティ	型	説明
id	String	プロファイルキー
profileName	String	プロファイルの名前
profileDescription	String	プロファイルの説明
isDefaultProfile	ブール型	プロファイルが既定として使用されるかどうかを表すブール値
createdDateTime	DateTimeOffset	BrandingProfile が作成された時刻
lastModifiedDateTime	DateTimeOffset	BrandingProfile が最後に変更された時刻
displayName	String	エンドユーザーに表示される会社名/組織名
themeColor	rgbColor	ポータルサイトアプリケーションと Web ポータルで使用されるプライマリテーマの色
showLogo	ブール型	管理者が指定したロゴイメージを表示するかどうかを表すブール型 (Boolean)
showDisplayNameNextToLogo	ブール型	管理者が指定した表示名をロゴイメージの横に表示するかどうかを表すブール値
themeColorLogo	mimeContent	ロゴの背後にテーマの色の背景があるポータルサイトアプリに表示されるロゴ画像
lightBackgroundLogo	mimeContent	ロゴの背後に明るい背景があるポータルサイトアプリに表示されるロゴ画像
landingPageCustomizedImage	mimeContent	ポータルサイトアプリのランディングページに表示されるカスタマイズされたイメージ
contactITName	String	IT サポートを担当する個人/組織の名前
contactITPhoneNumber	String	IT サポートを担当する個人/組織の電話番号
contactITEmailAddress	String	IT サポートを担当する個人/組織の電子メールアドレス
contactITNotes	String	IT サポートを担当する個人/組織に関するテキストコメント
onlineSupportSiteUrl	String	会社/組織の IT ヘルプデスクサイトへの URL
onlineSupportSiteName	String	会社/組織の IT ヘルプデスクサイトの表示名
privacyUrl	String	会社/組織のプライバシーポリシーへの URL
customPrivacyMessage	String	管理者がデバイスでアクセスできない内容に関するテキストコメント
customCanSeePrivacyMessage	String	管理者がデバイスでアクセスできる内容に関するテキストコメント
customCantSeePrivacyMessage	String	管理者がデバイスでアクセスできない内容に関するテキストコメント
isRemoveDeviceDisabled	ブール型	管理者が企業所有デバイスで [デバイスの削除] アクションを無効にしたかどうかを表すブール値。
isFactoryResetDisabled	ブール型	管理者が企業所有デバイスで "ファクトリリセット" アクションを無効にしたかどうかを表すブール値。
companyPortalBlockedActions	companyPortalBlockedAction コレクション	プラットフォームとデバイスの所有権の種類に応じて、ポータルサイトでブロックされたアクションのコレクション。
disableDeviceCategorySelection	ブール型	デバイスカテゴリの選択がポータルサイトに表示されるかどうかを示すブール値
showAzureADEnterpriseApps	ブール型	AzureAD Enterprise Apps がポータルサイトに表示されるかどうかを示すブール値
showOfficeWebApps	ブール型	ポータルサイトに Office WebApps が表示されるかどうかを示すブール値
showConfigurationManagerApps	ブール型	Configuration Manager Apps がポータルサイトに表示されるかどうかを示すブール値
sendDeviceOwnershipChangePushNotification	ブール型	デバイスの所有権の種類が個人から企業に変更されたときにプッシュ通知がユーザーに送信されるかどうかを示すブール型 (Boolean)
enrollmentAvailability	enrollmentAvailabilityOptions	エンドユーザーに表示されるカスタマイズされたデバイス登録フロー。可能な値は `availableWithPrompts`、`availableWithoutPrompts`、`unavailable` です。
disableClientTelemetry	ブール型	すべてのクライアントから Intune サービスに送信されるテレメトリに適用されます。無効にすると、クライアント内のすべてのプロアクティブなトラブルシューティングと問題の警告がオフになり、テレメトリ設定がデバイスユーザーに対して非アクティブまたは非表示に表示されます。
roleScopeTagIds	String collection	ブランド化プロファイルに割り当てられたスコープタグの一覧

応答

成功した場合、このメソッドは応答コード 201 Created と intuneBrandingProfile オブジェクトを応答本文に返します。

例

要求

以下は、要求の例です。

POST https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles
Content-type: application/json
Content-length: 2059

{
  "@odata.type": "#microsoft.graph.intuneBrandingProfile",
  "profileName": "Profile Name value",
  "profileDescription": "Profile Description value",
  "isDefaultProfile": true,
  "displayName": "Display Name value",
  "themeColor": {
    "@odata.type": "microsoft.graph.rgbColor",
    "r": 1,
    "g": 1,
    "b": 1
  },
  "showLogo": true,
  "showDisplayNameNextToLogo": true,
  "themeColorLogo": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "lightBackgroundLogo": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "landingPageCustomizedImage": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "contactITName": "Contact ITName value",
  "contactITPhoneNumber": "Contact ITPhone Number value",
  "contactITEmailAddress": "Contact ITEmail Address value",
  "contactITNotes": "Contact ITNotes value",
  "onlineSupportSiteUrl": "https://example.com/onlineSupportSiteUrl/",
  "onlineSupportSiteName": "Online Support Site Name value",
  "privacyUrl": "https://example.com/privacyUrl/",
  "customPrivacyMessage": "Custom Privacy Message value",
  "customCanSeePrivacyMessage": "Custom Can See Privacy Message value",
  "customCantSeePrivacyMessage": "Custom Cant See Privacy Message value",
  "isRemoveDeviceDisabled": true,
  "isFactoryResetDisabled": true,
  "companyPortalBlockedActions": [
    {
      "@odata.type": "microsoft.graph.companyPortalBlockedAction",
      "platform": "androidForWork",
      "ownerType": "company",
      "action": "remove"
    }
  ],
  "disableDeviceCategorySelection": true,
  "showAzureADEnterpriseApps": true,
  "showOfficeWebApps": true,
  "showConfigurationManagerApps": true,
  "sendDeviceOwnershipChangePushNotification": true,
  "enrollmentAvailability": "availableWithoutPrompts",
  "disableClientTelemetry": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}

応答

以下は、応答の例です。注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。実際の呼び出しではすべてのプロパティが返されます。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 2231

{
  "@odata.type": "#microsoft.graph.intuneBrandingProfile",
  "id": "fcd6136c-136c-fcd6-6c13-d6fc6c13d6fc",
  "profileName": "Profile Name value",
  "profileDescription": "Profile Description value",
  "isDefaultProfile": true,
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "themeColor": {
    "@odata.type": "microsoft.graph.rgbColor",
    "r": 1,
    "g": 1,
    "b": 1
  },
  "showLogo": true,
  "showDisplayNameNextToLogo": true,
  "themeColorLogo": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "lightBackgroundLogo": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "landingPageCustomizedImage": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "contactITName": "Contact ITName value",
  "contactITPhoneNumber": "Contact ITPhone Number value",
  "contactITEmailAddress": "Contact ITEmail Address value",
  "contactITNotes": "Contact ITNotes value",
  "onlineSupportSiteUrl": "https://example.com/onlineSupportSiteUrl/",
  "onlineSupportSiteName": "Online Support Site Name value",
  "privacyUrl": "https://example.com/privacyUrl/",
  "customPrivacyMessage": "Custom Privacy Message value",
  "customCanSeePrivacyMessage": "Custom Can See Privacy Message value",
  "customCantSeePrivacyMessage": "Custom Cant See Privacy Message value",
  "isRemoveDeviceDisabled": true,
  "isFactoryResetDisabled": true,
  "companyPortalBlockedActions": [
    {
      "@odata.type": "microsoft.graph.companyPortalBlockedAction",
      "platform": "androidForWork",
      "ownerType": "company",
      "action": "remove"
    }
  ],
  "disableDeviceCategorySelection": true,
  "showAzureADEnterpriseApps": true,
  "showOfficeWebApps": true,
  "showConfigurationManagerApps": true,
  "sendDeviceOwnershipChangePushNotification": true,
  "enrollmentAvailability": "availableWithoutPrompts",
  "disableClientTelemetry": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}

次の方法で共有

intuneBrandingProfile を作成する

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース