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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - Theme string
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - Theme string
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme String
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme string
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme str
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme String
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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) -> Groupfunc 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - Theme string
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - Theme string
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme String
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme string
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme str
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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.Groupresource, 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 totruefor 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_membersproperty 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,SubscribeNewGroupMembersandWelcomeEmailDisabled. 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_membershipblock as documented below. Required whentypescontainsDynamicMembership. Cannot be used with themembersproperty. - 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_allowedproperty 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_listsproperty 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_clientsproperty 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_enabledorsecurity_enabledmust be specified. Only Microsoft 365 groups can be mail enabled (see thetypesproperty). - 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_membershipblock.!> Warning Do not use the
membersproperty 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_enabledormail_enabledmust be specified. A Microsoft 365 group can be security enabled and mail enabled (see thetypesproperty). - theme String
 - The colour theme for a Microsoft 365 group. Possible values are 
Blue,Green,Orange,Pink,Purple,RedorTeal. 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_enabledis 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 haveHiddenmembershipvisibility and this value must be set when the group is created. By default, security groups will receivePrivatevisibility and Microsoft 365 groups will receivePublicvisibility.Group Name Uniqueness Group names are not unique within Azure Active Directory. Use the
prevent_duplicate_namesargument 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
DynamicMembershipin the set oftypesfor 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
DynamicMembershipin the set oftypesfor 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
DynamicMembershipin the set oftypesfor 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
DynamicMembershipin the set oftypesfor 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
DynamicMembershipin the set oftypesfor 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
DynamicMembershipin the set oftypesfor 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 
azureadTerraform Provider.