azureADWindowsAutopilotDeploymentProfile を作成する

[アーティクル]
04/21/2024

名前空間: microsoft.graph

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

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

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

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

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

アクセス許可

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

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

HTTP 要求

POST /deviceManagement/windowsAutopilotDeploymentProfiles

要求ヘッダー

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

要求本文

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

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

プロパティ	型	説明
id	String	WindowsAutopilotDeploymentProfile から継承されたプロファイルキー
displayName	String	デプロイプロファイルの表示名。最大許容長は 200 文字です。既定で返されます。サポート: $select、$top、$skip、$orderby。 $Search と $filter はサポートされていません。 windowsAutopilotDeploymentProfile から継承
説明	String	デプロイプロファイルの説明。最大許容長は 1500 文字です。サポート: $select、$top、$skip、$orderBy。 $Search と $filter はサポートされていません。 windowsAutopilotDeploymentProfile から継承
language	String	デバイスの構成時に使用する言語コード。例: en-US。既定値は os-default です。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。読み取り専用です。 2024 年 5 月以降、このプロパティはサポートされなくなり、非推奨としてマークされます。代わりにロケールを使用してください。 windowsAutopilotDeploymentProfile から継承
ロケール	String	デバイスを構成するときに使用するロケール (言語)。例: en-US。既定値は os-default です。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。 windowsAutopilotDeploymentProfile から継承
createdDateTime	DateTimeOffset	デプロイプロファイルが作成された日時。値は変更できず、プロファイルの作成時に自動的に設定されます。タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、'2014-01-01T00:00:00Z' のようになります。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。読み取り専用です。 windowsAutopilotDeploymentProfile から継承
lastModifiedDateTime	DateTimeOffset	デプロイプロファイルが最後に変更された日時。値は手動では更新できず、プロファイルに変更が加えられると自動的に設定されます。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、'2014-01-01T00:00:00Z'.のようになります。サポート: $select、$top、$skip。 $Search、$orderBy、$filterは読み取り専用ではサポートされていません。 windowsAutopilotDeploymentProfile から継承
outOfBoxExperienceSettings	outOfBoxExperienceSettings	Autopilot デバイスで既定のエクスペリエンスのために使用されるWindows Autopilot Deployment プロファイル設定。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。読み取り専用です。 2024 年 5 月以降、このプロパティはサポートされなくなり、非推奨としてマークされます。代わりに outOfBoxExperienceSetting を使用します。 windowsAutopilotDeploymentProfile から継承
outOfBoxExperienceSetting	outOfBoxExperienceSetting	既定のエクスペリエンスのためにデバイスによって使用されるWindows Autopilot Deployment プロファイル設定。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。 windowsAutopilotDeploymentProfile から継承
enrollmentStatusScreenSettings	windowsEnrollmentStatusScreenSettings	登録状態画面の設定 windowsAutopilotDeploymentProfile から継承
extractHardwareHash	ブール型	プロファイルがハードウェアハッシュ値の抽出と Windows Autopilot へのデバイスの登録をサポートするかどうかを示します。 TRUE の場合は、次に成功したチェックインでハードウェア抽出と Windows Autopilot 登録が行われるかどうかを示します。 FALSE の場合、ハードウェアハッシュ抽出と Windows Autopilot 登録は行われません。既定値は FALSE です。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。読み取り専用です。 2024 年 5 月以降、このプロパティはサポートされなくなり、非推奨としてマークされます。代わりに hardwareHashExtractionEnabled を使用します。 windowsAutopilotDeploymentProfile から継承
hardwareHashExtractionEnabled	ブール型	プロファイルがハードウェアハッシュ値の抽出と Windows Autopilot へのデバイスの登録をサポートするかどうかを示します。 TRUE の場合は、次に成功したチェックインでハードウェア抽出と Windows Autopilot 登録が行われるかどうかを示します。 FALSE の場合、ハードウェアハッシュ抽出と Windows Autopilot 登録は行われません。既定値は FALSE です。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。 windowsAutopilotDeploymentProfile から継承
deviceNameTemplate	String	Autopilot デバイスの名前を付けるために使用されるテンプレート。これはカスタムテキストであり、デバイスのシリアル番号またはランダムに生成された番号を含めることもできます。テンプレートによって生成されるテキストの長さの合計は 15 文字以下です。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。 windowsAutopilotDeploymentProfile から継承
deviceType	windowsAutopilotDeviceType	このプロファイルが適用される Windows デバイスの種類。指定できる値には、windowsPc、holoLens、virtualMachine などがあります。既定値は windowsPc です。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。 windowsAutopilotDeploymentProfile から継承されます。使用可能な値: `windowsPc`、`surfaceHub2`、`holoLens`、`surfaceHub2S`、`virtualMachine`、`unknownFutureValue`。
enableWhiteGlove	ブール型	Out of Box エクスペリエンス (OOBE) 中に、事前プロビジョニングされた展開モードでユーザーが Windows Autopilot を使用できるかどうかを示します。 TRUE の場合は、事前プロビジョニングされた展開モードの Windows Autopilot が許可されていることを示します。 false の場合、事前プロビジョニングされた展開モードの Windows Autopilot は許可されません。既定値は "FALSE" です。読み取り専用です。 2024 年 5 月以降、このプロパティはサポートされなくなり、非推奨としてマークされます。代わりに、事前プロビジョニングAllowed を使用します。 windowsAutopilotDeploymentProfile から継承
preprovisioningAllowed	ブール型	Out of Box エクスペリエンス (OOBE) 中に、事前プロビジョニングされた展開モードでユーザーが Windows Autopilot を使用できるかどうかを示します。 TRUE の場合、OOBE の事前プロビジョニング済み展開モードの Windows Autopilot の使用が許可されていることを示します。 false の場合、OOBE の事前プロビジョニング済み展開モードの Windows Autopilot は許可されません。既定値は "FALSE" です。 windowsAutopilotDeploymentProfile から継承
roleScopeTagIds	String collection	デプロイプロファイルのロールスコープタグの一覧。 windowsAutopilotDeploymentProfile から継承
managementServiceAppId	String	クライアントデバイスベースの登録検出中に使用される Entra 管理サービスのアプリ ID。サポート: $select、$top、$skip。 $Search、$orderBy、$filterはサポートされていません。 windowsAutopilotDeploymentProfile から継承

応答

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

例

要求

以下は、要求の例です。

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

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "language": "Language value",
  "locale": "Locale value",
  "outOfBoxExperienceSettings": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
    "hidePrivacySettings": true,
    "hideEULA": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "skipKeyboardSelectionPage": true,
    "hideEscapeLink": true
  },
  "outOfBoxExperienceSetting": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
    "privacySettingsHidden": true,
    "eulaHidden": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "keyboardSelectionPageSkipped": true,
    "escapeLinkHidden": true
  },
  "enrollmentStatusScreenSettings": {
    "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
    "hideInstallationProgress": true,
    "allowDeviceUseBeforeProfileAndAppInstallComplete": true,
    "blockDeviceSetupRetryByUser": true,
    "allowLogCollectionOnInstallFailure": true,
    "customErrorMessage": "Custom Error Message value",
    "installProgressTimeoutInMinutes": 15,
    "allowDeviceUseOnInstallFailure": true
  },
  "extractHardwareHash": true,
  "hardwareHashExtractionEnabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "deviceType": "surfaceHub2",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "id": "e2ec4e69-4e69-e2ec-694e-ece2694eece2",
  "displayName": "Display Name value",
  "description": "Description value",
  "language": "Language value",
  "locale": "Locale value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "outOfBoxExperienceSettings": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
    "hidePrivacySettings": true,
    "hideEULA": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "skipKeyboardSelectionPage": true,
    "hideEscapeLink": true
  },
  "outOfBoxExperienceSetting": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
    "privacySettingsHidden": true,
    "eulaHidden": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "keyboardSelectionPageSkipped": true,
    "escapeLinkHidden": true
  },
  "enrollmentStatusScreenSettings": {
    "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
    "hideInstallationProgress": true,
    "allowDeviceUseBeforeProfileAndAppInstallComplete": true,
    "blockDeviceSetupRetryByUser": true,
    "allowLogCollectionOnInstallFailure": true,
    "customErrorMessage": "Custom Error Message value",
    "installProgressTimeoutInMinutes": 15,
    "allowDeviceUseOnInstallFailure": true
  },
  "extractHardwareHash": true,
  "hardwareHashExtractionEnabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "deviceType": "surfaceHub2",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}

次の方法で共有