本頁是否能提供幫助?
您對此內容的意見反應十分重要。 請告訴我們您的想法。
其他意見反應?
剩餘 1500 個字元
Create User(s)

建立使用者

更新日期: 2015年5月

重要事項:本主題中的內容可能會過期。請參閱新的互動式圖形 API 文件,以取得 Azure AD Graph API 最新的參考文件。您可以參考互動式文件,從文件本身內的租用戶範例嘗試 REST 作業。文件更新只會在互動式文件上進行,且本主題將於未來移除。

「建立使用者」作業會在目錄中建立一或多個新使用者。

針對使用 2013-11-08 版或更新版本要求的 使用者 物件加入了 immutableId 屬性。使用 2013-11-08 版或更新版本建立使用者時,如果 userPrincipalName (UPN) 包含同盟網域,則必須指定此屬性。

此要求的建構如下。將 mytenantdomain 以您的 Azure Active Directory 租用戶網域取代,例如:contoso.onmicrosoft.com。需要 api-version 查詢字串參數。本主題中的範例是使用租用戶網域將租用戶定址。如需租用戶定址的其他方式,請參閱在 Graph API 中將實體和作業定址

 

HTTP 方法 要求 URI HTTP 版本

POST

https://graph.windows.net/mytenantdomain/users?api-version=2013-04-05

HTTP 1.1

 

要求標頭 說明

授權

必要項。由 Azure Active Directory 發出的承載權杖。如需詳細資訊,請參閱Authentication Scenarios for Azure AD

Content-Type

必要項。要求主體中內容的媒體類型。

Content-Length

必要項。要求的長度 (以位元組為單位)。

具有 使用者 主題中所指定最基本屬性的一或多個 User 實體。指定的密碼必須符合租用戶的密碼複雜性需求。如需密碼複雜性需求的詳細資訊,請參閱 使用者 主題。以下的範例要求顯示成功建立使用者所需的最基本屬性。

下列範例要求會使用 2013-04-05 版在目錄中建立新使用者:

POST https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=2013-04-05 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net
Content-Length: 252

{
    "accountEnabled": true,
    "displayName": "Alex Wu",
    "mailNickname": "AlexW",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
}


下列範例要求會使用 2013-11-08 版並指定 immutableId 屬性,在目錄中建立新使用者:

POST https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=2013-11-08 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net
Content-Length: 293

{
    "accountEnabled": true,
    "displayName": "Alex Wu",
    "mailNickname": "AlexW",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
    "immutableId": "6SNZnFLe6jOI3n68hjO5zA=="
}


成功的作業會傳回狀態碼 201 已建立

 

回應標頭 說明

位置

所建立使用者的 URI,其包含了物件識別碼。

ocp-aad-diagnostics-server-name

執行要求的作業之伺服器的識別碼。

ocp-aad-session-key

識別目錄服務目前工作階段的索引鍵。

在傳送上述範例要求時會收到以下範例回應。

HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Length: 982
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Location: https://directory.windows.net/contoso.onmicrosoft.com/directoryObjects/4e971521-101a-4311-94f4-0917d7218b4e/Microsoft.WindowsAzure.ActiveDirectory.User
Server: Microsoft-IIS/7.5
ocp-aad-diagnostics-server-name: XDALV0qN1u6zqj4Uo0sPtNcrP2gqE1lnhxOWAGczrDE=
request-id: 65230a2c-0477-4fb8-9cd5-adb796f8eb29
client-request-id: ae924da9-55ea-433a-b14e-da2ef9fcd6af
x-ms-dirapi-data-contract-version: 1.0
ocp-aad-session-key: eHD4TUXUT8mNc01h-PGrQAw0kfAGmLi_T64SX_h1OGu8mTPZXTZfa6HCCDc7-r7pMultoOn3oDO0ciBl8PzNAkRHkc2BD-tUnUJI3bYWT7T3YxjW2s0dortRi6yKrCf4Qx9m67uJmCT5FhqZsgNAvw.FujkHs6N4TinxXNQi_y41v8vDIrI1DKDQXyhexHvdY8
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ARR/2.5
X-Powered-By: ASP.NET
Date: Wed, 27 Mar 2013 22:59:47 GMT

{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/Microsoft.WindowsAzure.ActiveDirectory.User/@Element",
    "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.User",
    "objectType": "User",
    "objectId": "4e971521-101a-4311-94f4-0917d7218b4e",
    "accountEnabled": true,
    "assignedLicenses": [],
    "assignedPlans": [],
    "city": null,
    "country": null,
    "department": null,
    "dirSyncEnabled": null,
    "displayName": "Alex Wu",
    "facsimileTelephoneNumber": null,
    "givenName": null,
    "jobTitle": null,
    "lastDirSyncTime": null,
    "mail": null,
    "mailNickname": "AlexW",
    "mobile": null,
    "otherMails": [],
    "passwordPolicies": null,
    "passwordProfile": null,
    "physicalDeliveryOfficeName": null,
    "postalCode": null,
    "preferredLanguage": null,
    "provisionedPlans": [],
    "provisioningErrors": [],
    "proxyAddresses": [],
    "state": null,
    "streetAddress": null,
    "surname": null,
    "telephoneNumber": null,
    "thumbnailPhoto@odata.mediaContentType": "image",
    "usageLocation": null,
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
}

另請參閱

概念

使用者

顯示:
© 2015 Microsoft