Azure AD

使用说明

Integrate Azure Active Directory into your workflows. List, create, update, and delete users and groups. Manage group memberships programmatically.

工具

`microsoft_ad_list_users`

List users in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`top`	number	否	Maximum number of users to return (default 100, max 999)
`filter`	string	否	OData filter expression (e.g., "department eq 'Sales'")
`search`	string	否	Search string to filter users by displayName or mail

输出

参数	类型	描述
`users`	array	List of users
`userCount`	number	Number of users returned

`microsoft_ad_get_user`

Get a user by ID or user principal name from Azure AD

输入

参数	类型	必填	描述
`userId`	string	是	User ID or user principal name (e.g., "user@example.com")

输出

参数	类型	描述
`user`	object	User details
↳ `id`	string	User ID
↳ `displayName`	string	Display name
↳ `givenName`	string	First name
↳ `surname`	string	Last name
↳ `userPrincipalName`	string	User principal name (email)
↳ `mail`	string	Email address
↳ `jobTitle`	string	Job title
↳ `department`	string	Department
↳ `officeLocation`	string	Office location
↳ `mobilePhone`	string	Mobile phone number
↳ `accountEnabled`	boolean	Whether the account is enabled

`microsoft_ad_create_user`

Create a new user in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`displayName`	string	是	Display name for the user
`mailNickname`	string	是	Mail alias for the user
`userPrincipalName`	string	是	User principal name (e.g., "user@example.com")
`password`	string	是	Initial password for the user
`accountEnabled`	boolean	是	Whether the account is enabled
`givenName`	string	否	First name
`surname`	string	否	Last name
`jobTitle`	string	否	Job title
`department`	string	否	Department
`officeLocation`	string	否	Office location
`mobilePhone`	string	否	Mobile phone number

输出

参数	类型	描述
`user`	object	Created user details
↳ `id`	string	User ID
↳ `displayName`	string	Display name
↳ `givenName`	string	First name
↳ `surname`	string	Last name
↳ `userPrincipalName`	string	User principal name (email)
↳ `mail`	string	Email address
↳ `jobTitle`	string	Job title
↳ `department`	string	Department
↳ `officeLocation`	string	Office location
↳ `mobilePhone`	string	Mobile phone number
↳ `accountEnabled`	boolean	Whether the account is enabled

`microsoft_ad_update_user`

Update user properties in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`userId`	string	是	User ID or user principal name
`displayName`	string	否	Display name
`givenName`	string	否	First name
`surname`	string	否	Last name
`jobTitle`	string	否	Job title
`department`	string	否	Department
`officeLocation`	string	否	Office location
`mobilePhone`	string	否	Mobile phone number
`accountEnabled`	boolean	否	Whether the account is enabled

输出

参数	类型	描述
`updated`	boolean	Whether the update was successful
`userId`	string	ID of the updated user

`microsoft_ad_delete_user`

Delete a user from Azure AD (Microsoft Entra ID). The user is moved to a temporary container and can be restored within 30 days.

输入

参数	类型	必填	描述
`userId`	string	是	User ID or user principal name

输出

参数	类型	描述
`deleted`	boolean	Whether the deletion was successful
`userId`	string	ID of the deleted user

`microsoft_ad_list_groups`

List groups in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`top`	number	否	Maximum number of groups to return (default 100, max 999)
`filter`	string	否	OData filter expression (e.g., "securityEnabled eq true")
`search`	string	否	Search string to filter groups by displayName or description

输出

参数	类型	描述
`groups`	array	List of groups
`groupCount`	number	Number of groups returned

`microsoft_ad_get_group`

Get a group by ID from Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`groupId`	string	是	Group ID

输出

参数	类型	描述
`group`	object	Group details
↳ `id`	string	Group ID
↳ `displayName`	string	Display name
↳ `description`	string	Group description
↳ `mail`	string	Email address
↳ `mailEnabled`	boolean	Whether mail is enabled
↳ `mailNickname`	string	Mail nickname
↳ `securityEnabled`	boolean	Whether security is enabled
↳ `groupTypes`	array	Group types
↳ `visibility`	string	Group visibility
↳ `createdDateTime`	string	Creation date

`microsoft_ad_create_group`

Create a new group in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`displayName`	string	是	Display name for the group
`mailNickname`	string	是	Mail alias for the group (ASCII only, max 64 characters)
`description`	string	否	Group description
`mailEnabled`	boolean	是	Whether mail is enabled (true for Microsoft 365 groups)
`securityEnabled`	boolean	是	Whether security is enabled (true for security groups)
`groupTypes`	string	否	Group type: "Unified" for Microsoft 365 group, leave empty for security group
`visibility`	string	否	Group visibility: "Private" or "Public"

输出

参数	类型	描述
`group`	object	Created group details
↳ `id`	string	Group ID
↳ `displayName`	string	Display name
↳ `description`	string	Group description
↳ `mail`	string	Email address
↳ `mailEnabled`	boolean	Whether mail is enabled
↳ `mailNickname`	string	Mail nickname
↳ `securityEnabled`	boolean	Whether security is enabled
↳ `groupTypes`	array	Group types
↳ `visibility`	string	Group visibility
↳ `createdDateTime`	string	Creation date

`microsoft_ad_update_group`

Update group properties in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`groupId`	string	是	Group ID
`displayName`	string	否	Display name
`description`	string	否	Group description
`mailNickname`	string	否	Mail alias
`visibility`	string	否	Group visibility: "Private" or "Public"

输出

参数	类型	描述
`updated`	boolean	Whether the update was successful
`groupId`	string	ID of the updated group

`microsoft_ad_delete_group`

Delete a group from Azure AD (Microsoft Entra ID). Microsoft 365 and security groups can be restored within 30 days.

输入

参数	类型	必填	描述
`groupId`	string	是	Group ID

输出

参数	类型	描述
`deleted`	boolean	Whether the deletion was successful
`groupId`	string	ID of the deleted group

`microsoft_ad_list_group_members`

List members of a group in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`groupId`	string	是	Group ID
`top`	number	否	Maximum number of members to return (default 100, max 999)

输出

参数	类型	描述
`members`	array	List of group members
`memberCount`	number	Number of members returned

`microsoft_ad_add_group_member`

Add a member to a group in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`groupId`	string	是	Group ID
`memberId`	string	是	User ID of the member to add

输出

参数	类型	描述
`added`	boolean	Whether the member was added successfully
`groupId`	string	Group ID
`memberId`	string	Member ID that was added

`microsoft_ad_remove_group_member`

Remove a member from a group in Azure AD (Microsoft Entra ID)

输入

参数	类型	必填	描述
`groupId`	string	是	Group ID
`memberId`	string	是	User ID of the member to remove

输出

参数	类型	描述
`removed`	boolean	Whether the member was removed successfully
`groupId`	string	Group ID
`memberId`	string	Member ID that was removed

Azure AD

On this page