intuneBrandingProfile を更新する

[アーティクル]
11/22/2024

名前空間: 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 要求

PATCH /deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}

要求ヘッダー

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

要求本文

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

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

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

応答

成功した場合、このメソッドは応答コード 200 OK と、応答本文で更新された intuneBrandingProfile オブジェクトを返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
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 200 OK
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 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース