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 要求
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"
]
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示