azuread.Group
Explore with Pulumi AI
Manages a group within Azure Active Directory.
API Permissions
The following API permissions are required in order to use this resource.
When authenticated with a service principal, this resource requires one of the following application roles: Group.ReadWrite.All
or Directory.ReadWrite.All
.
Alternatively, if the authenticated service principal is also an owner of the group being managed, this resource can use the application role: Group.Create
.
If using the assignable_to_role
property, this resource additionally requires the RoleManagement.ReadWrite.Directory
application role.
If specifying owners for a group, which are user principals, this resource additionally requires one of the following application roles: User.Read.All
, User.ReadWrite.All
, Directory.Read.All
or Directory.ReadWrite.All
When authenticated with a user principal, this resource requires one of the following directory roles: Groups Administrator
, User Administrator
or Global Administrator
When creating this resource in administrative units exclusively, the role Groups Administrator
is required to be scoped on any administrative unit used.
The external_senders_allowed
, auto_subscribe_new_members
, hide_from_address_lists
and hide_from_outlook_clients
properties can only be configured when authenticating as a user and cannot be configured when authenticating as a service principal. Additionally, the user being used for authentication must be a Member of the tenant where the group is being managed and not a Guest. This is a known API issue; please see the Microsoft Graph Known Issues official documentation.
Example Usage
Basic example
import * as pulumi from "@pulumi/pulumi";
import * as azuread from "@pulumi/azuread";
const current = azuread.getClientConfig({});
const example = new azuread.Group("example", {
displayName: "example",
owners: [current.then(current => current.objectId)],
securityEnabled: true,
});
import pulumi
import pulumi_azuread as azuread
current = azuread.get_client_config()
example = azuread.Group("example",
display_name="example",
owners=[current.object_id],
security_enabled=True)
package main
import (
"github.com/pulumi/pulumi-azuread/sdk/v5/go/azuread"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
current, err := azuread.GetClientConfig(ctx, nil, nil)
if err != nil {
return err
}
_, err = azuread.NewGroup(ctx, "example", &azuread.GroupArgs{
DisplayName: pulumi.String("example"),
Owners: pulumi.StringArray{
pulumi.String(current.ObjectId),
},
SecurityEnabled: pulumi.Bool(true),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureAD = Pulumi.AzureAD;
return await Deployment.RunAsync(() =>
{
var current = AzureAD.GetClientConfig.Invoke();
var example = new AzureAD.Group("example", new()
{
DisplayName = "example",
Owners = new[]
{
current.Apply(getClientConfigResult => getClientConfigResult.ObjectId),
},
SecurityEnabled = true,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azuread.AzureadFunctions;
import com.pulumi.azuread.Group;
import com.pulumi.azuread.GroupArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var current = AzureadFunctions.getClientConfig();
var example = new Group("example", GroupArgs.builder()
.displayName("example")
.owners(current.applyValue(getClientConfigResult -> getClientConfigResult.objectId()))
.securityEnabled(true)
.build());
}
}
resources:
example:
type: azuread:Group
properties:
displayName: example
owners:
- ${current.objectId}
securityEnabled: true
variables:
current:
fn::invoke:
Function: azuread:getClientConfig
Arguments: {}
Microsoft 365 group
import * as pulumi from "@pulumi/pulumi";
import * as azuread from "@pulumi/azuread";
const current = azuread.getClientConfig({});
const groupOwner = new azuread.User("group_owner", {
userPrincipalName: "example-group-owner@example.com",
displayName: "Group Owner",
mailNickname: "example-group-owner",
password: "SecretP@sswd99!",
});
const example = new azuread.Group("example", {
displayName: "example",
mailEnabled: true,
mailNickname: "ExampleGroup",
securityEnabled: true,
types: ["Unified"],
owners: [
current.then(current => current.objectId),
groupOwner.objectId,
],
});
import pulumi
import pulumi_azuread as azuread
current = azuread.get_client_config()
group_owner = azuread.User("group_owner",
user_principal_name="example-group-owner@example.com",
display_name="Group Owner",
mail_nickname="example-group-owner",
password="SecretP@sswd99!")
example = azuread.Group("example",
display_name="example",
mail_enabled=True,
mail_nickname="ExampleGroup",
security_enabled=True,
types=["Unified"],
owners=[
current.object_id,
group_owner.object_id,
])
package main
import (
"github.com/pulumi/pulumi-azuread/sdk/v5/go/azuread"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
current, err := azuread.GetClientConfig(ctx, nil, nil)
if err != nil {
return err
}
groupOwner, err := azuread.NewUser(ctx, "group_owner", &azuread.UserArgs{
UserPrincipalName: pulumi.String("example-group-owner@example.com"),
DisplayName: pulumi.String("Group Owner"),
MailNickname: pulumi.String("example-group-owner"),
Password: pulumi.String("SecretP@sswd99!"),
})
if err != nil {
return err
}
_, err = azuread.NewGroup(ctx, "example", &azuread.GroupArgs{
DisplayName: pulumi.String("example"),
MailEnabled: pulumi.Bool(true),
MailNickname: pulumi.String("ExampleGroup"),
SecurityEnabled: pulumi.Bool(true),
Types: pulumi.StringArray{
pulumi.String("Unified"),
},
Owners: pulumi.StringArray{
pulumi.String(current.ObjectId),
groupOwner.ObjectId,
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureAD = Pulumi.AzureAD;
return await Deployment.RunAsync(() =>
{
var current = AzureAD.GetClientConfig.Invoke();
var groupOwner = new AzureAD.User("group_owner", new()
{
UserPrincipalName = "example-group-owner@example.com",
DisplayName = "Group Owner",
MailNickname = "example-group-owner",
Password = "SecretP@sswd99!",
});
var example = new AzureAD.Group("example", new()
{
DisplayName = "example",
MailEnabled = true,
MailNickname = "ExampleGroup",
SecurityEnabled = true,
Types = new[]
{
"Unified",
},
Owners = new[]
{
current.Apply(getClientConfigResult => getClientConfigResult.ObjectId),
groupOwner.ObjectId,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azuread.AzureadFunctions;
import com.pulumi.azuread.User;
import com.pulumi.azuread.UserArgs;
import com.pulumi.azuread.Group;
import com.pulumi.azuread.GroupArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var current = AzureadFunctions.getClientConfig();
var groupOwner = new User("groupOwner", UserArgs.builder()
.userPrincipalName("example-group-owner@example.com")
.displayName("Group Owner")
.mailNickname("example-group-owner")
.password("SecretP@sswd99!")
.build());
var example = new Group("example", GroupArgs.builder()
.displayName("example")
.mailEnabled(true)
.mailNickname("ExampleGroup")
.securityEnabled(true)
.types("Unified")
.owners(
current.applyValue(getClientConfigResult -> getClientConfigResult.objectId()),
groupOwner.objectId())
.build());
}
}
resources:
groupOwner:
type: azuread:User
name: group_owner
properties:
userPrincipalName: example-group-owner@example.com
displayName: Group Owner
mailNickname: example-group-owner
password: SecretP@sswd99!
example:
type: azuread:Group
properties:
displayName: example
mailEnabled: true
mailNickname: ExampleGroup
securityEnabled: true
types:
- Unified
owners:
- ${current.objectId}
- ${groupOwner.objectId}
variables:
current:
fn::invoke:
Function: azuread:getClientConfig
Arguments: {}
Group with members
Coming soon!
Coming soon!
Coming soon!
Coming soon!
Coming soon!
resources:
example:
type: azuread:User
properties:
displayName: J Doe
owners:
- ${current.objectId}
password: notSecure123
userPrincipalName: jdoe@example.com
exampleGroup:
type: azuread:Group
name: example
properties:
displayName: MyGroup
owners:
- ${current.objectId}
securityEnabled: true
members:
- ${example.objectId}
variables:
current:
fn::invoke:
Function: azuread:getClientConfig
Arguments: {}
Group with dynamic membership
import * as pulumi from "@pulumi/pulumi";
import * as azuread from "@pulumi/azuread";
const current = azuread.getClientConfig({});
const example = new azuread.Group("example", {
displayName: "MyGroup",
owners: [current.then(current => current.objectId)],
securityEnabled: true,
types: ["DynamicMembership"],
dynamicMembership: {
enabled: true,
rule: "user.department -eq \"Sales\"",
},
});
import pulumi
import pulumi_azuread as azuread
current = azuread.get_client_config()
example = azuread.Group("example",
display_name="MyGroup",
owners=[current.object_id],
security_enabled=True,
types=["DynamicMembership"],
dynamic_membership=azuread.GroupDynamicMembershipArgs(
enabled=True,
rule="user.department -eq \"Sales\"",
))
package main
import (
"github.com/pulumi/pulumi-azuread/sdk/v5/go/azuread"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
current, err := azuread.GetClientConfig(ctx, nil, nil)
if err != nil {
return err
}
_, err = azuread.NewGroup(ctx, "example", &azuread.GroupArgs{
DisplayName: pulumi.String("MyGroup"),
Owners: pulumi.StringArray{
pulumi.String(current.ObjectId),
},
SecurityEnabled: pulumi.Bool(true),
Types: pulumi.StringArray{
pulumi.String("DynamicMembership"),
},
DynamicMembership: &azuread.GroupDynamicMembershipArgs{
Enabled: pulumi.Bool(true),
Rule: pulumi.String("user.department -eq \"Sales\""),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureAD = Pulumi.AzureAD;
return await Deployment.RunAsync(() =>
{
var current = AzureAD.GetClientConfig.Invoke();
var example = new AzureAD.Group("example", new()
{
DisplayName = "MyGroup",
Owners = new[]
{
current.Apply(getClientConfigResult => getClientConfigResult.ObjectId),
},
SecurityEnabled = true,
Types = new[]
{
"DynamicMembership",
},
DynamicMembership = new AzureAD.Inputs.GroupDynamicMembershipArgs
{
Enabled = true,
Rule = "user.department -eq \"Sales\"",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azuread.AzureadFunctions;
import com.pulumi.azuread.Group;
import com.pulumi.azuread.GroupArgs;
import com.pulumi.azuread.inputs.GroupDynamicMembershipArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var current = AzureadFunctions.getClientConfig();
var example = new Group("example", GroupArgs.builder()
.displayName("MyGroup")
.owners(current.applyValue(getClientConfigResult -> getClientConfigResult.objectId()))
.securityEnabled(true)
.types("DynamicMembership")
.dynamicMembership(GroupDynamicMembershipArgs.builder()
.enabled(true)
.rule("user.department -eq \"Sales\"")
.build())
.build());
}
}
resources:
example:
type: azuread:Group
properties:
displayName: MyGroup
owners:
- ${current.objectId}
securityEnabled: true
types:
- DynamicMembership
dynamicMembership:
enabled: true
rule: user.department -eq "Sales"
variables:
current:
fn::invoke:
Function: azuread:getClientConfig
Arguments: {}
Create Group Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Group(name: string, args: GroupArgs, opts?: CustomResourceOptions);
@overload
def Group(resource_name: str,
args: GroupArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Group(resource_name: str,
opts: Optional[ResourceOptions] = None,
display_name: Optional[str] = None,
mail_enabled: Optional[bool] = None,
assignable_to_role: Optional[bool] = None,
mail_nickname: Optional[str] = None,
onpremises_group_type: Optional[str] = None,
members: Optional[Sequence[str]] = None,
dynamic_membership: Optional[GroupDynamicMembershipArgs] = None,
external_senders_allowed: Optional[bool] = None,
hide_from_address_lists: Optional[bool] = None,
hide_from_outlook_clients: Optional[bool] = None,
administrative_unit_ids: Optional[Sequence[str]] = None,
behaviors: Optional[Sequence[str]] = None,
auto_subscribe_new_members: Optional[bool] = None,
description: Optional[str] = None,
owners: Optional[Sequence[str]] = None,
prevent_duplicate_names: Optional[bool] = None,
provisioning_options: Optional[Sequence[str]] = None,
security_enabled: Optional[bool] = None,
theme: Optional[str] = None,
types: Optional[Sequence[str]] = None,
visibility: Optional[str] = None,
writeback_enabled: Optional[bool] = None)
func NewGroup(ctx *Context, name string, args GroupArgs, opts ...ResourceOption) (*Group, error)
public Group(string name, GroupArgs args, CustomResourceOptions? opts = null)
type: azuread:Group
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args GroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args GroupArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args GroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args GroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args GroupArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var groupResource = new AzureAD.Group("groupResource", new()
{
DisplayName = "string",
MailEnabled = false,
AssignableToRole = false,
MailNickname = "string",
OnpremisesGroupType = "string",
Members = new[]
{
"string",
},
DynamicMembership = new AzureAD.Inputs.GroupDynamicMembershipArgs
{
Enabled = false,
Rule = "string",
},
ExternalSendersAllowed = false,
HideFromAddressLists = false,
HideFromOutlookClients = false,
AdministrativeUnitIds = new[]
{
"string",
},
Behaviors = new[]
{
"string",
},
AutoSubscribeNewMembers = false,
Description = "string",
Owners = new[]
{
"string",
},
PreventDuplicateNames = false,
ProvisioningOptions = new[]
{
"string",
},
SecurityEnabled = false,
Theme = "string",
Types = new[]
{
"string",
},
Visibility = "string",
WritebackEnabled = false,
});
example, err := azuread.NewGroup(ctx, "groupResource", &azuread.GroupArgs{
DisplayName: pulumi.String("string"),
MailEnabled: pulumi.Bool(false),
AssignableToRole: pulumi.Bool(false),
MailNickname: pulumi.String("string"),
OnpremisesGroupType: pulumi.String("string"),
Members: pulumi.StringArray{
pulumi.String("string"),
},
DynamicMembership: &azuread.GroupDynamicMembershipArgs{
Enabled: pulumi.Bool(false),
Rule: pulumi.String("string"),
},
ExternalSendersAllowed: pulumi.Bool(false),
HideFromAddressLists: pulumi.Bool(false),
HideFromOutlookClients: pulumi.Bool(false),
AdministrativeUnitIds: pulumi.StringArray{
pulumi.String("string"),
},
Behaviors: pulumi.StringArray{
pulumi.String("string"),
},
AutoSubscribeNewMembers: pulumi.Bool(false),
Description: pulumi.String("string"),
Owners: pulumi.StringArray{
pulumi.String("string"),
},
PreventDuplicateNames: pulumi.Bool(false),
ProvisioningOptions: pulumi.StringArray{
pulumi.String("string"),
},
SecurityEnabled: pulumi.Bool(false),
Theme: pulumi.String("string"),
Types: pulumi.StringArray{
pulumi.String("string"),
},
Visibility: pulumi.String("string"),
WritebackEnabled: pulumi.Bool(false),
})
var groupResource = new Group("groupResource", GroupArgs.builder()
.displayName("string")
.mailEnabled(false)
.assignableToRole(false)
.mailNickname("string")
.onpremisesGroupType("string")
.members("string")
.dynamicMembership(GroupDynamicMembershipArgs.builder()
.enabled(false)
.rule("string")
.build())
.externalSendersAllowed(false)
.hideFromAddressLists(false)
.hideFromOutlookClients(false)
.administrativeUnitIds("string")
.behaviors("string")
.autoSubscribeNewMembers(false)
.description("string")
.owners("string")
.preventDuplicateNames(false)
.provisioningOptions("string")
.securityEnabled(false)
.theme("string")
.types("string")
.visibility("string")
.writebackEnabled(false)
.build());
group_resource = azuread.Group("groupResource",
display_name="string",
mail_enabled=False,
assignable_to_role=False,
mail_nickname="string",
onpremises_group_type="string",
members=["string"],
dynamic_membership=azuread.GroupDynamicMembershipArgs(
enabled=False,
rule="string",
),
external_senders_allowed=False,
hide_from_address_lists=False,
hide_from_outlook_clients=False,
administrative_unit_ids=["string"],
behaviors=["string"],
auto_subscribe_new_members=False,
description="string",
owners=["string"],
prevent_duplicate_names=False,
provisioning_options=["string"],
security_enabled=False,
theme="string",
types=["string"],
visibility="string",
writeback_enabled=False)
const groupResource = new azuread.Group("groupResource", {
displayName: "string",
mailEnabled: false,
assignableToRole: false,
mailNickname: "string",
onpremisesGroupType: "string",
members: ["string"],
dynamicMembership: {
enabled: false,
rule: "string",
},
externalSendersAllowed: false,
hideFromAddressLists: false,
hideFromOutlookClients: false,
administrativeUnitIds: ["string"],
behaviors: ["string"],
autoSubscribeNewMembers: false,
description: "string",
owners: ["string"],
preventDuplicateNames: false,
provisioningOptions: ["string"],
securityEnabled: false,
theme: "string",
types: ["string"],
visibility: "string",
writebackEnabled: false,
});
type: azuread:Group
properties:
administrativeUnitIds:
- string
assignableToRole: false
autoSubscribeNewMembers: false
behaviors:
- string
description: string
displayName: string
dynamicMembership:
enabled: false
rule: string
externalSendersAllowed: false
hideFromAddressLists: false
hideFromOutlookClients: false
mailEnabled: false
mailNickname: string
members:
- string
onpremisesGroupType: string
owners:
- string
preventDuplicateNames: false
provisioningOptions:
- string
securityEnabled: false
theme: string
types:
- string
visibility: string
writebackEnabled: false
Group Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Group resource accepts the following input properties:
- Display
Name string - The display name for the group.
- Administrative
Unit List<string>Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- Assignable
To boolRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - Auto
Subscribe boolNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Behaviors List<string>
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - Description string
- The description for the group.
- Dynamic
Membership Pulumi.Azure AD. Inputs. Group Dynamic Membership - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - External
Senders boolAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Mail
Enabled bool - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - Mail
Nickname string - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- Members List<string>
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- Onpremises
Group stringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - Owners List<string>
- A set of owners who own this group. Supported object types are Users or Service Principals
- Prevent
Duplicate boolNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - Provisioning
Options List<string> - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - Security
Enabled bool - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - Theme string
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - Types List<string>
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- Visibility string
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- Writeback
Enabled bool - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- Display
Name string - The display name for the group.
- Administrative
Unit []stringIds The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- Assignable
To boolRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - Auto
Subscribe boolNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Behaviors []string
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - Description string
- The description for the group.
- Dynamic
Membership GroupDynamic Membership Args - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - External
Senders boolAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Mail
Enabled bool - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - Mail
Nickname string - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- Members []string
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- Onpremises
Group stringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - Owners []string
- A set of owners who own this group. Supported object types are Users or Service Principals
- Prevent
Duplicate boolNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - Provisioning
Options []string - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - Security
Enabled bool - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - Theme string
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - Types []string
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- Visibility string
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- Writeback
Enabled bool - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- display
Name String - The display name for the group.
- administrative
Unit List<String>Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable
To BooleanRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto
Subscribe BooleanNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors List<String>
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description String
- The description for the group.
- dynamic
Membership GroupDynamic Membership - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external
Senders BooleanAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail
Enabled Boolean - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail
Nickname String - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members List<String>
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- onpremises
Group StringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - owners List<String>
- A set of owners who own this group. Supported object types are Users or Service Principals
- prevent
Duplicate BooleanNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning
Options List<String> - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - security
Enabled Boolean - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme String
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types List<String>
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility String
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback
Enabled Boolean - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- display
Name string - The display name for the group.
- administrative
Unit string[]Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable
To booleanRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto
Subscribe booleanNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors string[]
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description string
- The description for the group.
- dynamic
Membership GroupDynamic Membership - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external
Senders booleanAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From booleanAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From booleanOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail
Enabled boolean - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail
Nickname string - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members string[]
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- onpremises
Group stringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - owners string[]
- A set of owners who own this group. Supported object types are Users or Service Principals
- prevent
Duplicate booleanNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning
Options string[] - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - security
Enabled boolean - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme string
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types string[]
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility string
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback
Enabled boolean - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- display_
name str - The display name for the group.
- administrative_
unit_ Sequence[str]ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable_
to_ boolrole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto_
subscribe_ boolnew_ members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors Sequence[str]
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description str
- The description for the group.
- dynamic_
membership GroupDynamic Membership Args - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external_
senders_ boolallowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide_
from_ booladdress_ lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide_
from_ booloutlook_ clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail_
enabled bool - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail_
nickname str - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members Sequence[str]
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- onpremises_
group_ strtype - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - owners Sequence[str]
- A set of owners who own this group. Supported object types are Users or Service Principals
- prevent_
duplicate_ boolnames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning_
options Sequence[str] - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - security_
enabled bool - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme str
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types Sequence[str]
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility str
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback_
enabled bool - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- display
Name String - The display name for the group.
- administrative
Unit List<String>Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable
To BooleanRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto
Subscribe BooleanNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors List<String>
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description String
- The description for the group.
- dynamic
Membership Property Map - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external
Senders BooleanAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail
Enabled Boolean - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail
Nickname String - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members List<String>
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- onpremises
Group StringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - owners List<String>
- A set of owners who own this group. Supported object types are Users or Service Principals
- prevent
Duplicate BooleanNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning
Options List<String> - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - security
Enabled Boolean - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme String
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types List<String>
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility String
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback
Enabled Boolean - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
Outputs
All input properties are implicitly available as output properties. Additionally, the Group resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Mail string
- The SMTP address for the group.
- Object
Id string - The object ID of the group.
- Onpremises
Domain stringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Netbios stringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sam stringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Security stringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sync boolEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - Preferred
Language string - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- Proxy
Addresses List<string> - List of email addresses for the group that direct to the same group mailbox.
- Id string
- The provider-assigned unique ID for this managed resource.
- Mail string
- The SMTP address for the group.
- Object
Id string - The object ID of the group.
- Onpremises
Domain stringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Netbios stringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sam stringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Security stringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sync boolEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - Preferred
Language string - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- Proxy
Addresses []string - List of email addresses for the group that direct to the same group mailbox.
- id String
- The provider-assigned unique ID for this managed resource.
- mail String
- The SMTP address for the group.
- object
Id String - The object ID of the group.
- onpremises
Domain StringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Netbios StringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sam StringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Security StringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sync BooleanEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - preferred
Language String - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- proxy
Addresses List<String> - List of email addresses for the group that direct to the same group mailbox.
- id string
- The provider-assigned unique ID for this managed resource.
- mail string
- The SMTP address for the group.
- object
Id string - The object ID of the group.
- onpremises
Domain stringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Netbios stringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sam stringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Security stringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sync booleanEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - preferred
Language string - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- proxy
Addresses string[] - List of email addresses for the group that direct to the same group mailbox.
- id str
- The provider-assigned unique ID for this managed resource.
- mail str
- The SMTP address for the group.
- object_
id str - The object ID of the group.
- onpremises_
domain_ strname - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
netbios_ strname - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
sam_ straccount_ name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
security_ stridentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
sync_ boolenabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - preferred_
language str - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- proxy_
addresses Sequence[str] - List of email addresses for the group that direct to the same group mailbox.
- id String
- The provider-assigned unique ID for this managed resource.
- mail String
- The SMTP address for the group.
- object
Id String - The object ID of the group.
- onpremises
Domain StringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Netbios StringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sam StringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Security StringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sync BooleanEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - preferred
Language String - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- proxy
Addresses List<String> - List of email addresses for the group that direct to the same group mailbox.
Look up Existing Group Resource
Get an existing Group resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: GroupState, opts?: CustomResourceOptions): Group
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
administrative_unit_ids: Optional[Sequence[str]] = None,
assignable_to_role: Optional[bool] = None,
auto_subscribe_new_members: Optional[bool] = None,
behaviors: Optional[Sequence[str]] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
dynamic_membership: Optional[GroupDynamicMembershipArgs] = None,
external_senders_allowed: Optional[bool] = None,
hide_from_address_lists: Optional[bool] = None,
hide_from_outlook_clients: Optional[bool] = None,
mail: Optional[str] = None,
mail_enabled: Optional[bool] = None,
mail_nickname: Optional[str] = None,
members: Optional[Sequence[str]] = None,
object_id: Optional[str] = None,
onpremises_domain_name: Optional[str] = None,
onpremises_group_type: Optional[str] = None,
onpremises_netbios_name: Optional[str] = None,
onpremises_sam_account_name: Optional[str] = None,
onpremises_security_identifier: Optional[str] = None,
onpremises_sync_enabled: Optional[bool] = None,
owners: Optional[Sequence[str]] = None,
preferred_language: Optional[str] = None,
prevent_duplicate_names: Optional[bool] = None,
provisioning_options: Optional[Sequence[str]] = None,
proxy_addresses: Optional[Sequence[str]] = None,
security_enabled: Optional[bool] = None,
theme: Optional[str] = None,
types: Optional[Sequence[str]] = None,
visibility: Optional[str] = None,
writeback_enabled: Optional[bool] = None) -> Group
func GetGroup(ctx *Context, name string, id IDInput, state *GroupState, opts ...ResourceOption) (*Group, error)
public static Group Get(string name, Input<string> id, GroupState? state, CustomResourceOptions? opts = null)
public static Group get(String name, Output<String> id, GroupState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Administrative
Unit List<string>Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- Assignable
To boolRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - Auto
Subscribe boolNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Behaviors List<string>
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - Description string
- The description for the group.
- Display
Name string - The display name for the group.
- Dynamic
Membership Pulumi.Azure AD. Inputs. Group Dynamic Membership - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - External
Senders boolAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Mail string
- The SMTP address for the group.
- Mail
Enabled bool - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - Mail
Nickname string - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- Members List<string>
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- Object
Id string - The object ID of the group.
- Onpremises
Domain stringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Group stringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - Onpremises
Netbios stringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sam stringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Security stringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sync boolEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - Owners List<string>
- A set of owners who own this group. Supported object types are Users or Service Principals
- Preferred
Language string - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- Prevent
Duplicate boolNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - Provisioning
Options List<string> - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - Proxy
Addresses List<string> - List of email addresses for the group that direct to the same group mailbox.
- Security
Enabled bool - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - Theme string
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - Types List<string>
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- Visibility string
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- Writeback
Enabled bool - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- Administrative
Unit []stringIds The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- Assignable
To boolRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - Auto
Subscribe boolNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Behaviors []string
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - Description string
- The description for the group.
- Display
Name string - The display name for the group.
- Dynamic
Membership GroupDynamic Membership Args - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - External
Senders boolAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Hide
From boolOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- Mail string
- The SMTP address for the group.
- Mail
Enabled bool - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - Mail
Nickname string - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- Members []string
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- Object
Id string - The object ID of the group.
- Onpremises
Domain stringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Group stringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - Onpremises
Netbios stringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sam stringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Security stringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- Onpremises
Sync boolEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - Owners []string
- A set of owners who own this group. Supported object types are Users or Service Principals
- Preferred
Language string - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- Prevent
Duplicate boolNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - Provisioning
Options []string - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - Proxy
Addresses []string - List of email addresses for the group that direct to the same group mailbox.
- Security
Enabled bool - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - Theme string
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - Types []string
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- Visibility string
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- Writeback
Enabled bool - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- administrative
Unit List<String>Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable
To BooleanRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto
Subscribe BooleanNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors List<String>
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description String
- The description for the group.
- display
Name String - The display name for the group.
- dynamic
Membership GroupDynamic Membership - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external
Senders BooleanAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail String
- The SMTP address for the group.
- mail
Enabled Boolean - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail
Nickname String - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members List<String>
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- object
Id String - The object ID of the group.
- onpremises
Domain StringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Group StringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - onpremises
Netbios StringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sam StringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Security StringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sync BooleanEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - owners List<String>
- A set of owners who own this group. Supported object types are Users or Service Principals
- preferred
Language String - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- prevent
Duplicate BooleanNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning
Options List<String> - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - proxy
Addresses List<String> - List of email addresses for the group that direct to the same group mailbox.
- security
Enabled Boolean - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme String
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types List<String>
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility String
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback
Enabled Boolean - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- administrative
Unit string[]Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable
To booleanRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto
Subscribe booleanNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors string[]
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description string
- The description for the group.
- display
Name string - The display name for the group.
- dynamic
Membership GroupDynamic Membership - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external
Senders booleanAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From booleanAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From booleanOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail string
- The SMTP address for the group.
- mail
Enabled boolean - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail
Nickname string - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members string[]
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- object
Id string - The object ID of the group.
- onpremises
Domain stringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Group stringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - onpremises
Netbios stringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sam stringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Security stringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sync booleanEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - owners string[]
- A set of owners who own this group. Supported object types are Users or Service Principals
- preferred
Language string - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- prevent
Duplicate booleanNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning
Options string[] - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - proxy
Addresses string[] - List of email addresses for the group that direct to the same group mailbox.
- security
Enabled boolean - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme string
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types string[]
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility string
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback
Enabled boolean - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- administrative_
unit_ Sequence[str]ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable_
to_ boolrole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto_
subscribe_ boolnew_ members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors Sequence[str]
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description str
- The description for the group.
- display_
name str - The display name for the group.
- dynamic_
membership GroupDynamic Membership Args - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external_
senders_ boolallowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide_
from_ booladdress_ lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide_
from_ booloutlook_ clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail str
- The SMTP address for the group.
- mail_
enabled bool - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail_
nickname str - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members Sequence[str]
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- object_
id str - The object ID of the group.
- onpremises_
domain_ strname - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
group_ strtype - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - onpremises_
netbios_ strname - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
sam_ straccount_ name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
security_ stridentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises_
sync_ boolenabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - owners Sequence[str]
- A set of owners who own this group. Supported object types are Users or Service Principals
- preferred_
language str - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- prevent_
duplicate_ boolnames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning_
options Sequence[str] - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - proxy_
addresses Sequence[str] - List of email addresses for the group that direct to the same group mailbox.
- security_
enabled bool - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme str
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types Sequence[str]
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility str
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback_
enabled bool - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
- administrative
Unit List<String>Ids The object IDs of administrative units in which the group is a member. If specified, new groups will be created in the scope of the first administrative unit and added to the others. If empty, new groups will be created at the tenant level.
Caution When using the azuread.AdministrativeUnitMember resource, to manage Administrative Unit membership for a group, you will need to use an
ignore_changes = [administrative_unit_ids]
lifecycle meta argument for theazuread.Group
resource, in order to avoid a persistent diff.- assignable
To BooleanRole - Indicates whether this group can be assigned to an Azure Active Directory role. Defaults to
false
. Can only be set totrue
for security-enabled groups. Changing this forces a new resource to be created. - auto
Subscribe BooleanNew Members Indicates whether new members added to the group will be auto-subscribed to receive email notifications. Can only be set for Unified groups.
Known Permissions Issue The
auto_subscribe_new_members
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- behaviors List<String>
- A set of behaviors for a Microsoft 365 group. Possible values are
AllowOnlyMembersToPost
,HideGroupInOutlook
,SkipExchangeInstantOn
,SubscribeMembersToCalendarEventsDisabled
,SubscribeNewGroupMembers
andWelcomeEmailDisabled
. See official documentation for more details. Changing this forces a new resource to be created. - description String
- The description for the group.
- display
Name String - The display name for the group.
- dynamic
Membership Property Map - A
dynamic_membership
block as documented below. Required whentypes
containsDynamicMembership
. Cannot be used with themembers
property. - external
Senders BooleanAllowed Indicates whether people external to the organization can send messages to the group. Can only be set for Unified groups.
Known Permissions Issue The
external_senders_allowed
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanAddress Lists Indicates whether the group is displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_address_lists
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- hide
From BooleanOutlook Clients Indicates whether the group is displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Can only be set for Unified groups.
Known Permissions Issue The
hide_from_outlook_clients
property can only be set when authenticating as a Member user of the tenant and not when authenticating as a Guest user or as a service principal. Please see the Microsoft Graph Known Issues documentation.- mail String
- The SMTP address for the group.
- mail
Enabled Boolean - Whether the group is a mail enabled, with a shared group mailbox. At least one of
mail_enabled
orsecurity_enabled
must be specified. Only Microsoft 365 groups can be mail enabled (see thetypes
property). - mail
Nickname String - The mail alias for the group, unique in the organisation. Required for mail-enabled groups. Changing this forces a new resource to be created.
- members List<String>
A set of members who should be present in this group. Supported object types are Users, Groups or Service Principals. Cannot be used with the
dynamic_membership
block.!> Warning Do not use the
members
property at the same time as the azuread.GroupMember resource for the same group. Doing so will cause a conflict and group members will be removed.- object
Id String - The object ID of the group.
- onpremises
Domain StringName - The on-premises FQDN, also called dnsDomainName, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Group StringType - The on-premises group type that the AAD group will be written as, when writeback is enabled. Possible values are
UniversalDistributionGroup
,UniversalMailEnabledSecurityGroup
, orUniversalSecurityGroup
. - onpremises
Netbios StringName - The on-premises NetBIOS name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sam StringAccount Name - The on-premises SAM account name, synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Security StringIdentifier - The on-premises security identifier (SID), synchronised from the on-premises directory when Azure AD Connect is used.
- onpremises
Sync BooleanEnabled - Whether this group is synchronised from an on-premises directory (
true
), no longer synchronised (false
), or has never been synchronised (null
). - owners List<String>
- A set of owners who own this group. Supported object types are Users or Service Principals
- preferred
Language String - The preferred language for a Microsoft 365 group, in ISO 639-1 notation.
- prevent
Duplicate BooleanNames - If
true
, will return an error if an existing group is found with the same name. Defaults tofalse
. - provisioning
Options List<String> - A set of provisioning options for a Microsoft 365 group. The only supported value is
Team
. See official documentation for details. Changing this forces a new resource to be created. - proxy
Addresses List<String> - List of email addresses for the group that direct to the same group mailbox.
- security
Enabled Boolean - Whether the group is a security group for controlling access to in-app resources. At least one of
security_enabled
ormail_enabled
must be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypes
property). - theme String
- The colour theme for a Microsoft 365 group. Possible values are
Blue
,Green
,Orange
,Pink
,Purple
,Red
orTeal
. By default, no theme is set. - types List<String>
A set of group types to configure for the group. Supported values are
DynamicMembership
, which denotes a group with dynamic membership, andUnified
, which specifies a Microsoft 365 group. Required whenmail_enabled
is true. Changing this forces a new resource to be created.Supported Group Types At present, only security groups and Microsoft 365 groups can be created or managed with this resource. Distribution groups and mail-enabled security groups are not supported. Microsoft 365 groups can be security-enabled.
- visibility String
The group join policy and group content visibility. Possible values are
Private
,Public
, orHiddenmembership
. Only Microsoft 365 groups can haveHiddenmembership
visibility and this value must be set when the group is created. By default, security groups will receivePrivate
visibility and Microsoft 365 groups will receivePublic
visibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_names
argument to check for existing groups if you want to avoid name collisions.- writeback
Enabled Boolean - Whether the group will be written back to the configured on-premises Active Directory when Azure AD Connect is used.
Supporting Types
GroupDynamicMembership, GroupDynamicMembershipArgs
- Enabled bool
- Whether rule processing is "On" (true) or "Paused" (false).
- Rule string
The rule that determines membership of this group. For more information, see official documentation on membership rules syntax.
Dynamic Group Memberships Remember to include
DynamicMembership
in the set oftypes
for the group when configuring a dynamic membership rule. Dynamic membership is a premium feature which requires an Azure Active Directory P1 or P2 license.
- Enabled bool
- Whether rule processing is "On" (true) or "Paused" (false).
- Rule string
The rule that determines membership of this group. For more information, see official documentation on membership rules syntax.
Dynamic Group Memberships Remember to include
DynamicMembership
in the set oftypes
for the group when configuring a dynamic membership rule. Dynamic membership is a premium feature which requires an Azure Active Directory P1 or P2 license.
- enabled Boolean
- Whether rule processing is "On" (true) or "Paused" (false).
- rule String
The rule that determines membership of this group. For more information, see official documentation on membership rules syntax.
Dynamic Group Memberships Remember to include
DynamicMembership
in the set oftypes
for the group when configuring a dynamic membership rule. Dynamic membership is a premium feature which requires an Azure Active Directory P1 or P2 license.
- enabled boolean
- Whether rule processing is "On" (true) or "Paused" (false).
- rule string
The rule that determines membership of this group. For more information, see official documentation on membership rules syntax.
Dynamic Group Memberships Remember to include
DynamicMembership
in the set oftypes
for the group when configuring a dynamic membership rule. Dynamic membership is a premium feature which requires an Azure Active Directory P1 or P2 license.
- enabled bool
- Whether rule processing is "On" (true) or "Paused" (false).
- rule str
The rule that determines membership of this group. For more information, see official documentation on membership rules syntax.
Dynamic Group Memberships Remember to include
DynamicMembership
in the set oftypes
for the group when configuring a dynamic membership rule. Dynamic membership is a premium feature which requires an Azure Active Directory P1 or P2 license.
- enabled Boolean
- Whether rule processing is "On" (true) or "Paused" (false).
- rule String
The rule that determines membership of this group. For more information, see official documentation on membership rules syntax.
Dynamic Group Memberships Remember to include
DynamicMembership
in the set oftypes
for the group when configuring a dynamic membership rule. Dynamic membership is a premium feature which requires an Azure Active Directory P1 or P2 license.
Import
Groups can be imported using their object ID, e.g.
$ pulumi import azuread:index/group:Group my_group 00000000-0000-0000-0000-000000000000
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Active Directory (Azure AD) pulumi/pulumi-azuread
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azuread
Terraform Provider.