次の方法で共有


intuneBrandingProfile を作成する

名前空間: microsoft.graph

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

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

新しい intuneBrandingProfile オブジェクトを 作成します。

この 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 エンド ユーザーに表示されるカスタマイズされたデバイス登録フロー。 可能な値は availableWithPromptsavailableWithoutPromptsunavailable です。
disableClientTelemetry ブール型 すべてのクライアントから Intune サービスに送信されるテレメトリに適用されます。 無効にすると、クライアント内のすべてのプロアクティブなトラブルシューティングと問題の警告がオフになり、テレメトリ設定がデバイス ユーザーに対して非アクティブまたは非表示に表示されます。
roleScopeTagIds String collection ブランド 化プロファイルに割り当てられたスコープ タグの一覧

応答

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

要求

以下は、要求の例です。

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