Configure JSON Files for the Create Microsoft 365 Group Service

Refer to the following sections to configure the JSON files for a Create Microsoft 365 Group service and the associated policy, approval process, profiles, etc.

Create Microsoft 365 Group Service

The following table shows the properties of a Create Microsoft 365 service.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateGroupService. It indicates that the JSON file is used for the Create Microsoft 365 Group service.Enum
TenantEnter your Microsoft 365 tenant name.String
EnableHiddenOutlookExperienceSet to true if you want to hide the group from the Outlook client and Exchange global address list.Boolean
EnableWelcomeEmailSet to true if you want to send a welcome e-mail to users when they are added to Microsoft 365 Groups.Boolean
PrivacyConfigure the privacy settings for new Microsoft 365 Groups.EnumValid values:
Private
Public
PrivacyAssignByYou define the privacy settings for new Microsoft 365 Groups, or allow business users to configure the privacy when submitting requests via this service.EnumValid values:
BusinessUserWithRequired (Business users are required to define the group privacy.)
ITAdminWithReadOnly (IT administrator defines the group privacy or and the privacy is shown as read-only to business users.)
ITAdminWithHide (IT administrator defines the privacy and the privacy is not shown in the request form.)
SubscribeConfigure whether to allow Microsoft 365 Group members to receive copies of group conversations and events.EnumValid values:
NotSend
Send
SubscribeAssignByYou define the subscribe setting or allow business users to configure this field in the request form.EnumValid values:
BusinessUserWithRequired (Business users are required to define the subscribe settings.)
ITAdminWithReadOnly (IT administrator defines the subscribe settings and the subscribe settings are shown as read-only to business users.)
ITAdminWithHide (IT administrator defines the subscribe settings and the subscribe settings are not shown in the request form.)
OutsideSenderDefine whether you allow users outside the organization to send e-mails to Microsoft 365 Groups.EnumValid values:
Allow
Forbid
OutsideSenderAssignByYou define whether to allow users outside the organization to send e-mails to Microsoft 365 Groups, or allow business users to configure this field in the request form.EnumValid values:
BusinessUserWithRequired (Business users are required to configure the outside senders settings.)
ITAdminWithReadOnly (IT administrator configures the outside senders settings and the outside senders settings are shown as read-only to business users.)
ITAdminWithHide (IT administrator configures the outside senders settings and the outside senders settings are not shown in the request form.)
MembershipSettings > OwnersEnter one or more usernames or user taking certain roles to specify users to be the owners of the new Microsoft 365 Group.String collectionValid user roles:
$Requester
$ManagerOfRequester
$PrimaryGroupContact
$SecondaryGroupContact
MembershipSettings > OwnersAssignByYou assign users to be group owners, or allow business users to assign group owners in the request form.EnumValid values:
BusinessUserWithRequired (Business users are required to assign the group owners.)
ITAdminWithReadOnly (IT administrator assigns the group owners and the group owners are shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the group owners and the group owners are not shown in the request form.)
MembershipSettings > MembershipTypeSpecify a method to assign group members.EnumValid values:
Assigned (Manually select group members.)
Dynamic (Business users define rules to get group members dynamically.)
MembershipSettings > MembersEnter usernames or certain user roles to assign users to be group members.String collectionValid user roles:
$Requester
$ManagerOfRequester
$PrimaryGroupContact
$SecondaryGroupContact
MembershipSettings > MembersAssignByYou assign users to be group members, or allow business users to assign users in the request form.EnumValid values:
BusinessUserWithRequired (Business users are required to assign the group members.)
ITAdminWithReadOnly (IT administrator assigns the group members and the group members are shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the group members and the group members are not shown in the request form.)
MembershipSettings > EnableHiddenGroupMembershipSet to true if you want to enable hidden membership to hide the group members from users who are not members of the group.Boolean
MembershipSettings > EnableHiddenGroupMembershipAssignByYou define whether to enable the hidden membership, or allow business users to decide whether to enable the hidden membership in the request form.EnumValid values:
BusinessUserWithRequired (Business users are required to decide whether to enable the hidden membership.)
ITAdminWithReadOnly (IT administrator decides whether to enable the hidden membership and the selection is shown as read-only to business users.)
ITAdminWithHide (IT administrator decides whether to enable the hidden membership and the setting is not shown in the request form.)
MembershipSettings > DynamicMembershipRules > RuleNameSpecify a dynamic membership rule name.String
MembershipSettings > DynamicMembershipRules > RuleValueSpecify the value for the rule.String
MembershipSettings > DynamicMembershipRules > DisableEditRuleValueSet whether to allow requesters to define the rule value.StringValid values:
True
False
MembershipSettings > DynamicMembershipRules > RelationSpecify the relationship if you add multiple rule conditions to add group members.StringValid values:
And (The group members will be added based on all the rule conditions.)
Or (The group members will be added based on any of the rule conditions.)
MembershipSettings > DynamicMembershipRules > CategorySpecify a category for the rule.String
MembershipSettings > DynamicMembershipRules > ConditionSpecify the condition to define the rule value.String
MembershipSettings > DisableAddRemoveDynamicMembershipRulesSet whether to allow requesters to add or remove dynamic membership rules.StringValid values:
True
False
LinkSettings > EnablePlannerSet to true if you want to display links of Planner that will be created together with Microsoft 365 Groups.Boolean
LinkSettings > EnableTeamSiteSet to true if you want to display links of Site that will be created together with Microsoft 365 Groups.Boolean
LinkSettings > EnableFilesSet to true if you want to display links of Files (the Documents library) that will be created together with Microsoft 365 Groups.Boolean
LinkSettings > EnableConversationsSet to true if you want to display links of Conversations (group conversations in Outlook).Boolean
LinkSettings > EnableNotebookSet to true if you want to display links of Notebook that will be created together with Microsoft 365 Groups.Boolean
GroupNameConstructSettings > EnabledSet to true if you want to use prefix or suffix to construct the group name.Boolean
GroupNameConstructSettings - PrefixItems > TypeSpecify the type for the prefix as a rule.EnumValid values:
Text
Metadata
Attribute
GroupNameConstructSettings - PrefixItems > ValueEnter the value for the specified rule.String
GroupNameConstructSettings - SuffixItems > TypeSpecify the type for the suffix as a rule.EnumValid values:
Text
Metadata
Attribute
GroupNameConstructSettings - SuffixItems > ValueEnter the value for the specified rule.String
GroupNameConstructSettings - SuffixItems > ConstructRuleAssignByYou define group names for Microsoft 365 groups, or allow business users to define group names based on the prefixes/suffixes in your rules.EnumValid values:
BusinessUser (Business users can define group names based on the prefixes/suffixes in your rule.)
BusinessUserWithRequired (Business users are required to enter additional content for group names.)
ITAdminWithReadOnly (IT administrator defines the prefixes/suffixes and the group name is shown as read-only to business users.)
GroupIdConstructSettings > EnableAutoSequenceNumberSet to true if you want to automatically add a sequence number to the end of the group ID.Boolean
GroupIdConstructSettings > AutoSequenceNumberEnter the sequence number rule in the format of {nn} or {nn*}.String
GroupIdConstructSettings > GroupIdRuleChoose to construct group ID, or automatically populate group ID with group name and hide group ID from business users.EnumValid values:
ConstructGroupId
PopulateGroupIdWithGroupName
GroupIdConstructSettings > EnabledSet to true if you want to construct the group ID rule.Boolean
GroupIdConstructSettings - PrefixItems > TypeSpecify the type for the prefix as a rule.EnumValid values:
Text
Metadata
Attribute
GroupIdConstructSettings - PrefixItems > ValueEnter the value for the specified rule.String
GroupIdConstructSettings - SuffixItems > TypeSpecify the type for the suffix as a rule.EnumValid values:
Text
Metadata
Attribute
GroupIdConstructSettings - SuffixItems > ValueEnter the value for the specified rule.String
GroupIdConstructSettings > ConstructRuleAssignByYou define group names for Microsoft 365 groups, or allow business users to define group names based on the prefixes/suffixes in your rules.EnumValid values:
BusinessUser (Business users can define group IDs based on the prefixes/suffixes in your rule.)
BusinessUserWithRequired (Business users are required to enter additional content for group IDs.)
ITAdminWithReadOnly (IT administrator defines the prefixes/suffixes and the group ID is shown as read-only to business users.)
PreventDuplicateNameSet to true if you do not allow business users to request a new group using a name that is the same as the existing one.Boolean
EnableAppSet to true if you want to automatically enable AvePoint Cloud Governance App.Boolean
EnableGroupSitePanelSet to true if you want to automatically add the Cloud Governance Panel app part into the group team site.Boolean
HideRequestSummarySet to true if you want to hide the Request Summary field from the request form and use the service name and timestamp to automatically generate the request summary.Boolean
LanguageDefine the service language. The service language can be used to filter services when a business user starts a request.StringValid values:
English
French
German
Italian
Japanese
SingleApprovalProcessDefine a single approval process that will be used for the service. Enter the name of an approval process.String
CategoryEnter the name of a category that is used to organize the service.String
AvailableAsQuestionaireResultSet to true if you want to allow business users to access this service via questionnaire results.Boolean
AnyUserCanAccessByQuestionnaireSet to true if you want to allow all business users to access this service via questionnaire results regardless of the service permission conditions.Boolean
ShowServiceInCatalogSet to true if you want to allow business users to access this service via the service catalog.Boolean
AdminContactEnter the name of a user or a Microsoft Entra group to be the administrator contact who is responsible for the successful completion of the service.String
ServiceContactEnter the name of a user to be the service contact who will be the owner of the business process for the service.String
EnableMultipleApprovalProcessSet to true if you want to enable multiple approval processes that will be used for the service under certain conditions.Boolean
MultipleApprovalProcess – ConditionalApprovalProcesses > NameEnter a name for the conditional approval process.String
MultipleApprovalProcess – ConditionalApprovalProcesses > AlwaysRunSet to true if you want to always run this approval process.Boolean
ConditionSettings > RelationSpecify the logic options for the multiple added conditions.EnumValid values:
And
Or
ConditionSettings > SourceTypeSpecify the metadata source type.EnumValid values:
ServiceMetadata
GroupProperties
ConditionSettings > ConditionSpecify the condition to define the metadata value.EnumValid values:
Equals
Contains
HasNoGuest
HasExistingGuest
HasNewGuest
(The HasNoGuest, HasExistingGuest, HasNewGuest values are only available when you define NewlyMembers as the PropertyName.)
ConditionSettings > PropertyNameSpecify a group property name.
Note that you need to configure this field only when you define GroupProperties as the SourceType.
EnumValid values:
None
Privacy
Calssification
Owners
Members
NewlyMembers
Language
Subscribe
Outside
ConditionSettings > ValueEnter the metadata value.String
ConditionSettings > MetadataNameEnter the metadata name.String
ConditionSettings > ApprovalProcessSpecify an approval process that will be combined with the conditions configured above to create a conditional approval process. Enter an approval process name.String
ConditionSettings > DefaultApprovalProcessSpecify a default approval process for the service. Enter an approval process name.String
ConditionSettings > DefaultProcessMustDoSet to true if you want to use the default approval process as the last approval stage for all of the requests submitted via this service.Boolean
ConditionSettings > EnableCompletionEmailSet to true if you want to notify the requester and the approvers upon the request completion.Boolean
ConditionSettings > CompletionEmailTemplateEnter the name of an e-mail template used for sending notification e-mail to the requester and approvers.String
ServicePermissions > AllowAnyUserAccessSet to true if you want to allow all users to use this service.Boolean
ServicePermissions > MeetAllConditionsSet to true if you want to allow business users who meet certain conditions to use this service.Boolean
ServicePermissionDetails > PermissionTypeSpecify conditions for users who can use the request.EnumValid values:
UserOrGroup
AzureADProperty
ServicePermissionDetails > ValueDefine values for the corresponding condition type.String
ServicePermissionDetails > NameEnter usernames or group names.String
ServicePermissionDetails > TenantEnter your Microsoft 365 tenant name.String
ServicePermissionDetails > PropertyInputTypeSpecify the Microsoft Entra property type.EnumValid values:
Dropdown (It represents the built-in property.)
Manual (It represents the custom property.)
Metadatas > NameEnter the metadata name.String
Metadatas > AssignByYou set the default value for the metadata or allow business users to assign the metadata value.EnumValid values:
BusinessUser (Business users can set the metadata value.)
BusinessUserWithRequired (Business users are required to set the metadata value.)
ITAdminWithReadOnly (IT administrator sets the default metadata value and the value is shown as read-only to business users.)
ITAdminWithHide (IT administrator set the metadata value and the metadata is not shown in the request form.)
SingleLineOrMultipleLineTypeValue > ValueEnter a default value for the metadata.String
LinkTypeValue > TitleEnter the desired text to be the hyperlink title.String
LinkTypeValue > AddressEnter the address of the hyperlink.String
ChoiceTypeValue > ValuesEnter the choices you wish to provide.String collection
UserProfileTypeValue > ValueEnter a username to get the user's property value from the user profile.String
AzureAdTypeValue > ValueEnter a username to get the user's property value from Microsoft Entra.String
UserTypeValue > ValuesEnter usernames or group names.String collection
ManagedTypeValue > ValuesEnter terms that have been configured in your SharePoint term store.String collection
YesOrNoTypeValue > ValueSpecify a default value for the metadata, true or false.Boolean
YesOrNoTypeValue > DefaultTermLanguageSpecify a default display language for the terms and conditions.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
YesOrNoTypeValue > EnableTermsSet to true if you want to enable the desired terms and conditions. Note that if you enable the terms and conditions agreement, only Yes can be the default value.Boolean
YesOrNoTypeValue > TermsAndConditions > LanguageSpecify a language for the terms and conditions.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
YesOrNoTypeValue > TermsAndConditions > TermDefine the terms and conditions.String
YesOrNoTypeValue > TermsAndConditions > TrueValueEnter your preferred value to replace Yes.String
YesOrNoTypeValue > TermsAndConditions > FalseValueEnter your preferred value to replace No.String
YesOrNoTypeValue > TermsAndConditions > IsEnableCustomValueSet to true if you change default terms and conditions metadata to your preferred values.Boolean
YesOrNoTypeValue > TermsAndConditions > IsEnabledSet to true if you want to enable the language for the terms and conditions.Boolean
LanguageSettings > SelectedLanguagesSpecify a language for the group.String collectionValid values:
Afrikaans (Suid-Afrika)
Azərbaycan dili (Azərbaycan)
Bahasa Indonesia (Indonesia)
Bahasa Melayu (Brunei Darussalam)
Bahasa Melayu (Malaysia)
bosanski (Bosna i Hercegovina)
Català (Català)
čeština (Česká republika)
Cymraeg (Y Deyrnas Unedig)
dansk (Danmark)
Deutsch (Deutschland)
Deutsch (Liechtenstein)
Deutsch (Luxemburg)
Deutsch (Österreich)
Deutsch (Schweiz)
eesti (Eesti)
English (Australia)
English (Belize)
English (Canada)
English (Caribbean)
English (India)
English (Ireland)
English (Jamaica)
English (Malaysia)
English (New Zealand)
English (Philippines)
English (Singapore)
English (South Africa)
English (Trinidad and Tobago)
English (United Kingdom)
English (United States)
English (Zimbabwe)
español (Argentina)
español (Bolivia)
español (Chile)
español (Colombia)
español (Costa Rica)
español (Ecuador)
español (El Salvador)
español (España, alfabetización internacional)
español (Estados Unidos)
español (Guatemala)
español (Honduras)
español (México)
español (Nicaragua)
español (Panamá)
español (Paraguay)
español (Perú)
español (Puerto Rico)
español (Republica Bolivariana de Venezuela)
español (República Dominicana)
español (Uruguay)
euskara (euskara)
Filipino (Pilipinas)
français (Belgique)
français (Canada)
français (France)
français (Luxembourg)
français (Principauté de Monaco)
français (Suisse)
Gaeilge (Éire)
Gàidhlig (An Rìoghachd Aonaichte)
galego (galego)
Hausa (Nijeriya)
hrvatski (Bosna i Hercegovina)
hrvatski (Hrvatska)
íslenska (Ísland)
italiano (Italia)
italiano (Svizzera)
Kiswahili (Kenya)
latviešu (Latvija)
Lëtzebuergesch (Lëtzebuerg)
lietuvių (Lietuva)
magyar (Magyarország)
Malti (Malta)
Nederlands (België)
Nederlands (Nederland)
norsk, bokmål (Norge)
norsk, nynorsk (Noreg)
O'zbekcha (O'zbekiston Respublikasi)
polski (Polska)
português (Angola)
português (Brasil)
português (Portugal)
Reo Māori (Aotearoa)
română (Republica Moldova)
română (România)
runa shimi (Ecuador Suyu)
runasimi (Peru)
runasimi (Qullasuyu)
Shqip (Shqipëria)
slovenčina (Slovenská republika)
slovenščina (Slovenija)
srpski (Srbija i Crna Gora (Bivša))
suomi (Suomi)
svenska (Finland)
svenska (Sverige)
Tiếng Việt (Việt Nam)
Türkçe (Türkiye)
Türkmen dili (Türkmenistan)
Valencià (Espanya)
Ελληνικά (Ελλάδα)
Беларуская (Беларусь)
български (България)
Кыргыз (Кыргызстан)
Қазақ (Қазақстан)
македонски јазик (Македонија)
Монгол хэл (Монгол улс)
русский (Россия)
српски (Босна и Херцеговина)
српски (Србија и Црна Гора (Бивша))
Татар (Россия)
українська (Україна)
Հայերեն (Հայաստան)
ქართული (საქართველო)
עברית (ישראל)
اردو (بھارت)
اُردو (پاکستان)
العربية (الأردن)
العربية (الإمارات العربية المتحدة)
العربية (البحرين)
العربية (الجزائر)
العربية (العراق)
العربية (الكويت)
العربية (المملكة العربية السعودية)
العربية (المملكة المغربية)
العربية (اليمن)
العربية (تونس)
العربية (سوريا)
العربية (عمان)
العربية (قطر)
العربية (لبنان)
العربية (ليبيا)
العربية (مصر)
درى (افغانستان)
سنڌي (پاکستان)
فارسى (ایران)
ئۇيغۇرچە (جۇڭخۇا خەلق جۇمھۇرىيىتى)
कोंकणी (भारत)
नेपाली (नेपाल)
नेपाली (भारत)
मराठी (भारत)
हिंदी (भारत)
অসমীয়া (ভাৰত)
বাংলা (বাংলাদেশ)
বাংলা (ভারত)
ਪੰਜਾਬੀ (ਭਾਰਤ)
ગુજરાતી (ભારત)
ଓଡ଼ିଆ (ଭାରତ)
தமிழ் (இந்தியா)
తెలుగు (భారత దేశం)
ಕನ್ನಡ (ಭಾರತ)
മലയാളം (ഭാരതം)
සිංහල (ශ්‍රී ලංකා)
ไทย (ไทย)
ພາສາລາວ (ສປປ ລາວ)
ភាសាខ្មែរ (កម្ពុជា)
አማርኛ (ኢትዮጵያ)
한국어(대한민국)
中文(中华人民共和国)
中文(台灣)
中文(新加坡)
中文(澳門特別行政區)
中文(香港特別行政區)
日本語 (日本)
LanguageSettings > DefaultLanguageSpecify a default language for the group.String
LanguageSettings > LanguageAssignByYou assign the language for the group, or allow business users to select the language when submitting a request via this service.EnumValid values:
BusinessUserWithRequired (Business users are required to assign the language for the group.)
ITAdminWithReadOnly (IT administrator assigns the language for the group and the language is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the language for the group and the language is not shown in the request form.)
ClassificationSettings > SelectedClassificationSpecify classifications available for new groups created via this service.String collection
ClassificationSettings > DefaultClassificationSpecify a default classification.String
ClassificationSettings > ClassificationAssignByYou assign the classification to groups, or allow business users to specify the group classification when submitting a request via this service.EnumValid values:
BusinessUser (Business users can assign the group classification.)
BusinessUserWithRequired (Business users are required to assign the group classification.)
ITAdminWithReadOnly (IT administrator assigns the group classification and the classification is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the group classification and the classification is not shown in the request form.)
SensitivitySettings > SelectedSensitivitySpecify sensitivity labels that're available for new groups created via this service.String collection
SensitivitySettings > DefaultSensitivitySpecify a default sensitivity label.String
SensitivitySettings > SensitivityAssignByYou assign the sensitivity label to groups, or allow business users to specify the group sensitivity label when submitting a request via this service.EnumValid values:
BusinessUser (Business users can assign the group sensitivity label.)
BusinessUserWithRequired (Business users are required to assign the group sensitivity label.)
ITAdminWithReadOnly (IT administrator assigns the group sensitivity label, and the sensitivity label is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the group sensitivity label, and the sensitivity label is not shown in the request form.)
EnableEditRequestInTaskSet to true if you want to allow approvers to edit the request when processing a task.Boolean
EnableNotifyRequesterWhenEditedSet to true if you want to notify the requester when the request is edited.Boolean
EditRequestEmailTemplateEnter the name of an e-mail template that will be used to send notifications when the service request is edited.String
IsTimeZoneEnabledSet to true if you want to define a standard time zone for the group team site.Bool
TimeZoneDefine the time zone for the group team sites.String
TimeZoneAssignByYou define the time zone to group team sites created by this service, or allow business users to select the time zone when submitting a service request for this service.StringValid values:
BusinessUserWithRequired (Business users are required to define the time zone.)
ITAdminWithReadOnly (IT administrator defines the time zone, and it is shown as read-only to business users.)
ITAdminWithHide (IT administrator defines the time zone, and it is not shown in the request form.)
IsLocaleEnabledSet to true if you want to define a locale to specify the way the group team site displays numbers, dates, and time.Bool
LocaleDefine the time zone for the group team sites.String
LocaleAssignByYou define the locale for group team sites created by this service, or allow business users to select the locale when submitting a service request for this service.StringValid values:
BusinessUserWithRequired (Business users are required to define the locale.)
ITAdminWithReadOnly (IT administrator defines the locale, and it is shown as read-only to business users.)
ITAdminWithHide (IT administrator defines the locale, and it is not shown in the request form.)
PrimaryContactEnter the name of a user to be the primary group contact.String
PrimaryContactAssignByYou assign the primary contact or allow business users to assign the primary contact when submitting a request via this service.EnumValid values:
BusinessUserWithRequired (Business users are required to assign the primary contact.)
ITAdminWithReadOnly (IT administrator assigns the primary contact, and the primary contact is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the primary contact and the primary contact is not shown in the request form.)
EnableNotifyPrimaryContactSet to true if you want to notify the primary group contact when the group is successfully created.Boolean
PrimaryContactEmailTemplateEnter the name of an e-mail template used to send the notification e-mail to the primary group contact.String
SecondaryContactEnter the name of a user to be the secondary group contact.String
EnableNotifySecondaryContactSet to true if you want to notify the secondary group contact when the group is successfully created.Boolean
SecondaryContactEmailTemplateEnter the name of an e-mail template used to send the notification e-mail to the secondary group contact.String
SecondaryContactAssignByYou assign the secondary group contact or allow business users to assign the secondary contact when submitting a request via this service.EnumValid values:
BusinessUserWithRequired (Business users are required to assign the secondary contact.)
ITAdminWithReadOnly (IT administrator assigns the secondary contact and the secondary contact is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the secondary contact and the secondary contact is not shown in the request form.)
HubSiteSettings > ConvertHubSiteTypeConfigure how to enable hub site functionality for the group team site.EnumValid values:
ConvertToHubSite
AssociateOneHubSite
HubSiteSettings > EnableHubSiteSet to true if you want to enable the hub site functionality for the group team site.Boolean
HubSiteSettings > AssociateHubSiteEnter a hub name.String
HubSiteSettings > HubSiteAssignByYou determine whether to enable the hub site functionality for the group team site, or allow business users to determine whether to enable hub site.EnumValid values:
BusinessUser (Business users can configure the hub site settings.)
BusinessUserWithRequired (Business users are required to configure the hub site settings.)
ITAdminWithReadOnly (IT administrator configures the hub site setting and the settings are shown as read-only to business users.)
ITAdminWithHide (IT administrator configures the hub site settings and the settings are not shown in the request form.)
ModernTeamSiteDesignSpecify a default site template for the new group team site. Enter a site template name.String
ModernTeamSiteDesignAssignByYou assign the site template or allow business users to assign the site template when submitting a request.EnumValid values:
BusinessUser (Business users can assign the site template.)
BusinessUserWithRequired (Business users are required to assign the site template.)
ITAdminWithReadOnly (IT administrator assigns the site template and the template is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the site template and the template is not shown in the request form.)
SelectedPoliciesEnter the name of the group policies that can be applied to the groups created by this service.String collection
DefaultPolicySpecify a default group policy that you wish to apply to the groups. Enter a group policy name.String
PolicyAssignByYou assign the group policy to groups created via this service, or allow business users to assign the group policy.EnumValid values:
BusinessUserWithRequired (Business users are required to assign the group policy.)
ITAdminWithReadOnly (IT administrator assigns the group policy and the policy is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the group policy and the policy is not shown in the request form.)
MultiGeoSettings > EnabledSet to true if you want the new groups to be created in different geo-locations.Boolean
MultiGeoSettings > MultiGeoOptionYou specify a geo location for the group created via this service, or assign the geo location according to the preferred data location (PDL) property of the requester or primary group contact.EnumValid values:
SpecifyLocationDirectly
SpecifyLocationByRole
MultiGeoSettings > SelectedLocationsEnter your desired geo locations.String collection
MultiGeoSettings > DefaultLocationSpecify a default geo location, and the geo location will be shown in the request form as the default option.StringThe default geo location must be one of the geo locations above that you specified.
MultiGeoSettings > MultiGeoAssignByYou specify the geo location, or allow business users to select the geo location.EnumValid values:
BusinessUserWithRequired (Business users are required to select the geo location.)
ITAdminWithReadOnly (IT administrator selects the geo location and it is shown as read-only to business users.)
ITAdminWithHide (IT administrator selects the geo location and it is not shown in the request form.)
MultiGeoSettings > UserRoleEnter user roles to specify users whose preferred data location (PDL) property will be retrieved to assign the geo location.EnumValid user roles:
$Requester
$PrimaryGroupContact
DuplicateActionThis property value determines how to deal with the service if there is an existing service with the same name. Use the new name with a suffix automatically added to the original service name, or do not create this service during the import process.EnumValid values:
CreateNewWithSuffix (The format of the new name is Servicename_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for the service.String
DescriptionEnter a description for the service.String

Group Policy

The following table shows the properties of a group policy.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateGroupPolicy. It indicates that the JSON file is used for the group policy.Enum
TenantEnter your Microsoft 365 tenant name.String
StorageQuotaEnter a number to specify the Microsoft 365 Group team site quota.Int32The unit is GB.
SharingSettings > EnableManageGroupSet to true if you want to set unique guest access settings for the groups.Boolean
SharingSettings > EnableGroupInviteGuestUserSet to true if you allow group owners to add people outside the organization to the group.Boolean
SharingSettings > AllowToInviteExternalUserSet to true if you allow group owners to invite new external users who are not already in Microsoft Entra.Boolean
SharingSettings > EnableManageTeamSiteSet to true if you want to set unique external sharing settings for the site collection associated with the group.Boolean
SharingSettings > EnableTeamSiteInviteGuestUserSet to true if you allow users to share the group team site content with people outside the organization.Boolean
SharingSettings > TeamSiteInviteTypeSpecify the scope of external users.EnumValid values:
Anyone
NewAndExist
Exist
Disabled
SharingSettings > AllowMembersShareSet to true if you allow users in the group to share the group team site and individual files and folders to other people.Boolean
SharingSettings > AllowMembersEditMembershipSet to true if you allow members to invite others to the site members group.Boolean
SharingSettings > AllowAccessRequestsSet to true if you allow users to request access to the group team site of the group applied with this policy.Boolean
SharingSettings > AccessRequestTypeSpecify who will receive access requests on the group team site.EnumValid values:
SpecifyEmail (Specific e-mail addresses)
OwnerGroup (The site owners group)
SharingSettings > RequestAccessEmailEnter the e-mail addresses of the approvers.String
SharingSettings > AccessRequestMessageDefine a custom message that can be shown to users who see the access request page.String
LifecycleSettings > DefaultApprovalProcessEnter the name of an approval process that will be used as the default approval process.String
LifecycleSettings > DeletionSettings > EnableNotifySet to true if you want to notify certain people when the group is deleted.Boolean
LifecycleSettings > DeletionSettings > NotifyUsersEnter usernames or user roles to specify users that will be notified.String collectionValid user roles:
$GroupOwners
$PrimaryGroupContact
$SecondaryGroupContact
LifecycleSettings > DeletionSettings > EmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
LifecycleSettings > DeletionSettings > EnabledSet to true if you want to allow business users to delete the group upon request.Boolean
LifecycleSettings > DeletionSettings > ApprovalProcessEnter the name of an approval process if you want to use a unique approval process for the group deletion request.String
LifecycleSettings > DeletionSettings > IsUsedDefaultProcessSet to true if you want to use the default approval process.Boolean
LifecycleSettings > ExtensionSettings > TypeSpecify the method to set the limit on the group lease extension.EnumValid values:
Each (Each extension must be a specific period of time.)
NoMore (Each extension cannot exceed a specific period of time.)
LifecycleSettings > ExtensionSettings > ConstantDurationEnter a number for the amount of time to configure the extension.Int32
LifecycleSettings > ExtensionSettings > ConstantDurationTypeSpecify the unit of time for the duration.EnumValid values:
Day
Week
Month
Year
LifecycleSettings > ExtensionSettings > MaxDurationEnter a number for the amount of time to set limit to the extension period.Int32
LifecycleSettings > ExtensionSettings > MaxDurationTypeSpecify the unit of time for the duration.EnumValid values:
Day
Week
Month
Year
LifecycleSettings > ExtensionSettings > EnabledSet to true if you want to allow business users to extend the lease of a group.Boolean
LifecycleSettings > ExtensionSettings > ApprovalProcessEnter the name of an approval process if you want to use a unique approval process for the group lease extension request.String
LifecycleSettings > ExtensionSettings > IsUsedDefaultProcessSet to true if you want to use the default approval process.Boolean
LifecycleSettings > ChangePolicySettings > IsDefineChangeToPoliciesSet to true if you want to show list of available policies for selection to limit what policies are presented to users in the Group Lifecycle Management - Change Group Policy service.Boolean
LifecycleSettings > ChangePolicySettings > SelectedPoliciesConfigure policies that are available to be selected.String collection
LifecycleSettings > ChangePolicySettings > EnabledSet to true if you want to allow business users to change the group policy.Boolean
LifecycleSettings > ChangePolicySettings > ApprovalProcessEnter the name of an approval process if you want to use a unique approval process for the group policy change request.String
LifecycleSettings > ChangePolicySettings > IsUsedDefaultProcessSet to true if you want to use the default approval process.Boolean
LifecycleSettings > ChangeQuotaSettings > ChangeOptionSpecify the quota change option to set limit for the quota change.EnumValid values:
AllowAnyValue (Allows business users to request to change site collection quota to any available size.)
WithinSpecifyLimit (Allows business users to increase or decrease the group team site quota, and the change cannot exceed the size defined in the MaxValue property.)
LifecycleSettings > ChangeQuotaSettings > MaxValueSpecify the size to limit the site quota change.Int32The unit is GB.
LifecycleSettings > ChangeQuotaSettings > EnabledSet to true if you want to allow business users to change the group team site quota.Boolean
LifecycleSettings > ChangeQuotaSettings > ApprovalProcessEnter the name of an approval process if you want to use a unique approval process for the group team site quota change request.String
LifecycleSettings > ChangeQuotaSettings > IsUsedDefaultProcessSet to true if you want to use the default approval process.Boolean
InactivityThresholdSettingsEnabledSet to true if you want to enable the group inactivity threshold.Boolean
InactivityThresholdSettingsDurationSpecify the amount of time for the inactivity threshold.Int32
InactivityThresholdSettingsDurationTypeSpecify the unit of time for the inactivity threshold.Enum
InactivityThresholdSettingsApprovalProcessEnter the name of an approval process. The approver configured in the approval process will be responsible for the group inactivity task.String
InactivityThresholdSettingsEnableWarningSet to true if you want to enable group inactivity threshold warning.Boolean
InactivityThresholdSettingsWarningReminderProfileEnter the name of a reminder profile.String
InactivityThresholdSettings > AdditionalActionSettings > EnableAdditionalActionSet to true if you want to enable an additional group lifecycle action.Boolean
InactivityThresholdSettings > AdditionalActionSettings > AdditionalActionTypeSpecify an additional group lifecycle action for escalation.EnumValid values:
None
Delete
Archive
InactivityThresholdSettings > AdditionalActionSettings > DurationThe additional group lifecycle actions will be started if the group inactivity threshold task is not completed after a specific period of time. Enter a number for the amount of time.Int32
InactivityThresholdSettings > AdditionalActionSettings > DurationTypeSpecify the unit of time for the duration.EnumValid values:
Day
Week
Month
Year
InactivityThresholdSettings > AdditionalActionSettings > EnableRemindSet to true if you want to enable a reminder for the approvers before the group deletion task is generated.Boolean
InactivityThresholdSettings > AdditionalActionSettings > ReminderProfileEnter the name of a reminder profile.String
LeaseThresholdSettingsEnabledSet to true if you want to enable the group lease management.Boolean
LeaseThresholdSettingsDurationSpecify the amount of time for the lease period.Int32
LeaseThresholdSettingsDurationTypeSpecify the unit of time for the lease period.Enum
LeaseThresholdSettingsApprovalProcessEnter the name of an approval process. The approver configured in the approval process will be responsible for the group lease expiration task.String
LeaseThresholdSettingsEnableWarningSet to true if you want to enable lease expiration warning.Boolean
LeaseThresholdSettingsWarningReminderProfileEnter the name of a reminder profile.String
LeaseThresholdSettings > AdditionalActionSettings > EnableAdditionalActionSet to true if you want to enable an additional group lifecycle action.Boolean
LeaseThresholdSettings > AdditionalActionSettings > AdditionalActionTypeSpecify an additional group lifecycle action for escalation.EnumValid values:
Delete
Archive
LeaseThresholdSettings > AdditionalActionSettings > DurationThe additional group lifecycle action will be started if the group lease expiration task is not completed after a specific period of time. Enter a number for the amount of time.Int32
LeaseThresholdSettings > AdditionalActionSettings > DurationTypeSpecify the unit of time for the duration.EnumValid values:
Day
Week
Month
Year
LeaseThresholdSettings > AdditionalActionSettings > EnableRemindSet to true if you want to enable a reminder for the approvers before a group deletion task is generated.Boolean
LeaseThresholdSettings > AdditionalActionSettings > ReminderProfileEnter the name of a reminder profile.String
QuotaThresholdSettings > EnabledSet to true if you want to enable the group team site quota threshold.Boolean
QuotaThresholdSettings > PercentageEnter a number to set the quota threshold.Int32
QuotaThresholdSettings > NotifyUsersSpecify users that will be notified when the group team site's storage reaches the specified percentage of the allocated quota.String collection
QuotaThresholdSettings > QuotaThresholdNotifyEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
DeactiveContactElectionSettings > EnabledSet to true if you want to enable automated ownership election process to start the ownership election process when either of the group contacts is deactivated.Boolean
DeactiveContactElectionSettings > EnableNotifyUsersSet to true if you want to notify specified people when both the primary and secondary contact are deactivated.Boolean
DeactiveContactElectionSettings > ElectionNotifyUsersEnter usernames, groups' e-mail addresses, or enter $ to specify a user role who will receive a copy of the notification e-mail.String collectionValid user role:
$GroupMembers
DeactiveContactElectionSettings > EnableNotifyTaskSet to true if you want to notify the user when the election task is assigned.Boolean
DeactiveContactElectionSettings > NotifyTaskEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
DeactiveContactElectionSettings > EnableNotifyPrimaryContactSet to true if you want to notify the primary contact when the group is assigned.Boolean
DeactiveContactElectionSettings > NotifyPrimaryContactEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
DeactiveContactElectionSettings > EnableNotifySecondaryContactSet to true if you want to notify the secondary contact when the group is assigned.Boolean
DeactiveContactElectionSettings > NotifySecondaryContactEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
DeactiveContactElectionSettings > DurationSpecify a number as the duration for each election stage.Int32
DeactiveContactElectionSettings > DurationTypeSpecify the unit of time for the duration.EnumValid values:
Day
Week
DeactiveContactElectionSettings > EnableRemindSet to true if you want to remind the nominated user before each nomination task expires.Boolean
DeactiveContactElectionSettings > ReminderProfileEnter the name of a reminder profile.String
EnableRenewalSet to true if you want to enable the renewal process for the group applied with the policy.Boolean
RenewalProfileEnter the name of a renewal profile.String
CategoryEnter the name of a category that is used to organize the group policy.String
DuplicateActionThis property value determines how to deal with the policy if there is an existing policy with the same name. Use the new name with a suffix automatically added to the original policy name, or do not create the policy during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the policy with the same name, the existing policy with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Policyname_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for this group policy.String
DescriptionEnter a description for this group policy.String

Approval Process

The following table shows the properties of an approval process.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateApprovalProcess. It indicates that the JSON file is used for the approval process.Enum
CategoryEnter the name of a category that is used to organize the approval process.String
CCEnter usernames or group names or user roles to specify additional users and/or groups that you want to be notified when the service request is completed without assigning tasks to them.String collectionValid user roles:
$ManagerOfApprover
$AdministratorContact
$ManagerOfRequester
$GroupOwners
$PrimaryGroupContact
$SecondaryGroupContact
BCCEnter usernames, group names, or user roles. They will be notified when the service request is completed without assigning tasks to them.String collectionValid user roles:
$ManagerOfApprover
$AdministratorContact
$PrimarySiteCollectionContact
$SecondarySiteCollectionContact
$PrimarySiteCollectionAdministrator
$ManagerOfRequester
$ApproversAndAllAssignees
StageOneSettings > ApproveOrderSpecify the order in which the approval tasks are assigned.EnumValid values:
Serial
Parallel
StageOneSettings > ApproversEnter usernames or certain user roles to specify users as approvers.String collectionValid user roles:
$Requester
$ManagerofRequester
$GroupMetadata("{Metadata Name}")
$GroupOwners
$PrimaryGroupContact
$SecondaryGroupContact
$ServiceMetadata("{MetadataName}")
StageOneSettings > DescriptionEnter an optional description for the first approval stage.String
StageOneSettings > NameEnter a name for the first approval stage.String
StageOneSettings > AllowAutocratSet to true if you allow the approval stage to complete when one approver approves.Boolean
StageOneSettings > AllowReassignSet to true if you allow approvers to reassign tasks to others.Boolean
StageOneSettings > DurationSetting > EnableDurationSet to true if you want to enable duration for the approval process.Boolean
StageOneSettings > DurationSetting > ReassigneeEnter a usernames or user role to specify the user that the task will be re-assigned to.StringValid user role:
$ManagerOfApprover
StageOneSettings > DurationSetting > EscalationUsersEnter usernames or a user role to specify users that will be notified.String collectionValid user role:
$ManagerOfApprover
StageOneSettings > DurationSetting > EnableDurationReminderSet to true if you want to enable reminder before the escalation.Boolean
StageOneSettings > DurationSetting > DurationEnter a number to specify the amount of time for the duration.Int32
StageOneSettings > DurationSetting > ReassignEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail to the approver when the task is re-assigned to them.String
StageOneSettings > DurationSetting > AutoRejectEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the approval task is automatically rejected.String
StageOneSettings > DurationSetting > NotifyEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the task is escalated.String
StageOneSettings > DurationSetting > DurationReminderProfileEnter the name of a reminder profile.String
StageOneSettings > DurationSetting > DurationTypeEnter a duration type.EnumValid values:
Day
Week
StageOneSettings > DurationSetting > EscalationTypeSpecify an escalation type.EnumValid values:
Notify
ReAssignTo
AutoReject
StageOneSettings > EmailSetting > EnableNotifyApproverWhenAssignedSet to true if you want to notify the approver when the task is assigned.Boolean
StageOneSettings > EmailSetting > NotifyApproverEmailTemplateEnter the name of an e-mail template that will be used to notify the approver when the task is assigned.String
StageOneSettings > EmailSetting > EnableNotifyRequesterWhenApprovedSet to true if you want to notify the requester when the request is approved.Boolean
StageOneSettings > EmailSetting > NotifyRequesterApprovedEmailTemplateEnter the name of an e-mail template that will be used to notify the requester when the request is approved.String
StageOneSettings > EmailSetting > EnableNotifyRequesterWhenRejectedSet to true if you want to notify the requester when the request is rejected.Boolean
StageOneSettings > EmailSetting > NotifyRequesterRejectedEmailTemplateEnter the name of an e-mail template that will be used to notify the requester when the request is rejected.String
StageOneSettings > EmailSetting > EnableNotifyApproverWhenCancelledSet to true if you want to notify the approver and requester when the request is canceled.Boolean
StageOneSettings > EmailSetting > NotifyApproverCancelledEmailTemplateEnter the name of an e-mail template that will be used to notify the requester and approver when the request is canceled.String
StageOneSettings > EmailSetting > EnableNotifyApproverWhenRejectedSet to true if you want to notify all previous approvers when the request is rejected.Boolean
StageOneSettings > EmailSetting > NotifyApproverRejectedEmailTemplateEnter the name of an e-mail template that will be used to notify all previous approvers when the request is rejected.String
StageTwoSettings > ApproveOrderSpecify the order in which the approval tasks are assigned.EnumValid values:
Serial
Parallel
StageTwoSettings > ApproversEnter usernames or certain user roles to specify users as approvers.String collectionValid user roles:
$Requester
$ManagerofRequester
$ManagerOfPreviousStageApprover
$GroupOwners
$PrimaryGroupContact
$SecondaryGroupContact
$GroupMetadata("{Metadata Name}")
$ServiceMetadata("{MetadataName}")
StageTwoSettings > DescriptionEnter an optional description for the second approval stage.String
StageTwoSettings > NameEnter a name for the second approval stage.String
StageTwoSettings > AllowAutocratSet to true if you allow the approval stage to complete when one approver approves.Boolean
StageTwoSettings > AllowReassignSet to true if you allow approvers to reassign tasks to others.Boolean
StageTwoSettings > DurationSetting > EnableDurationSet to true if you want to enable duration for the approval process.Boolean
StageTwoSettings > DurationSetting > ReassigneeEnter a username or user role to specify the user that the task will be re-assigned to.StringValid user role:
$ManagerOfApprover
StageTwoSettings > DurationSetting > EscalationUsersEnter usernames or a user role to specify users that will be notified.String collectionValid user role:
$ManagerOfApprover
StageTwoSettings > DurationSetting > EnableDurationReminderSet to true if you want to enable reminder before the escalation.Boolean
StageTwoSettings > DurationSetting > DurationEnter a number to specify the amount of time for the duration.Int32
StageTwoSettings > DurationSetting > ReassignEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail to the approver when the task is re-assigned to them.String
StageTwoSettings > DurationSetting > AutoRejectEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the approval task is automatically rejected.String
StageTwoSettings > DurationSetting > NotifyEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the task is escalated.String
StageTwoSettings > DurationSetting > DurationReminderProfileEnter the name of a reminder profile.String
StageTwoSettings > DurationSetting > DurationTypeEnter a duration type.EnumValid values:
Day
Week
StageTwoSettings > DurationSetting > EscalationTypeSpecify an escalation type.EnumValid values:
Notify
ReAssignTo
AutoReject
StageTwoSettings > EmailSetting > EnableNotifyApproverWhenAssignedSet to true if you want to notify the approver when the task is assigned.Boolean
StageTwoSettings > EmailSetting > NotifyApproverEmailTemplateEnter the name of an e-mail template that will be used to notify the approver when the task is assigned.String
StageTwoSettings > EmailSetting > EnableNotifyRequesterWhenApprovedSet to true if you want to notify the requester when the request is approved.Boolean
StageTwoSettings > EmailSetting > NotifyRequesterApprovedEmailTemplateEnter the name of an e-mail template that will be used to notify the requester when the request is approved.String
StageTwoSettings > EmailSetting > EnableNotifyRequesterWhenRejectedSet to true if you want to notify the requester when the request is rejected.Boolean
StageTwoSettings > EmailSetting > NotifyRequesterRejectedEmailTemplateEnter the name of an e-mail template that will be used to notify the requester when the request is rejected.String
StageTwoSettings > EmailSetting > EnableNotifyApproverWhenCancelledSet to true if you want to notify the approver and requester when the request is canceled.Boolean
StageTwoSettings > EmailSetting > NotifyApproverCancelledEmailTemplateEnter the name of an e-mail template that will be used to notify the requester and approver when the request is canceled.String
StageTwoSettings > EmailSetting > EnableNotifyApproverWhenRejectedSet to true if you want to notify all previous approvers when the request is rejected.Boolean
StageTwoSettings > EmailSetting > NotifyApproverRejectedEmailTemplateEnter the name of an e-mail template that will be used to notify all previous approvers when the request is rejected.String
StageThreeSettings > ApproveOrderSpecify the order in which the approval tasks are assigned.EnumValid values:
Serial
Parallel
StageThreeSettings > ApproversEnter usernames or certain user roles to specify users as approvers.String collectionValid user roles:
$Requester
$ManagerofRequester
$ManagerOfPreviousStageApprover
$GroupOwners
$PrimaryGroupContact
$SecondaryGroupContact
$GroupMetadata("{Metadata Name}")
$ServiceMetadata("{MetadataName}")
StageThreeSettings > DescriptionEnter an optional description for the third approval stage.String
StageThreeSettings > NameEnter a name for the third approval stage.String
StageThreeSettings > AllowAutocratSet to true if you allow the approval stage to complete when one approver approves.Boolean
StageThreeSettings > AllowReassignSet to true if you allow approvers to reassign tasks to others.Boolean
StageThreeSettings > DurationSetting > EnableDurationSet to true if you want to enable duration for the approval process.Boolean
StageThreeSettings > DurationSetting > ReassigneeEnter a username or user role to specify the user that the task will be re-assigned to.StringValid user role:
$ManagerOfApprover
StageThreeSettings > DurationSetting > EscalationUsersEnter usernames or a user role to specify users that will be notified.String collectionValid user role:
$ManagerOfApprover
StageThreeSettings > DurationSetting > EnableDurationReminderSet to true if you want to enable reminder before the escalation.Boolean
StageThreeSettings > DurationSetting > DurationEnter a number to specify the amount of time for the duration.Int32
StageThreeSettings > DurationSetting > ReassignEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail to the approver when the task is re-assigned to them.String
StageThreeSettings > DurationSetting > AutoRejectEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the approval task is automatically rejected.String
StageThreeSettings > DurationSetting > NotifyEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the task is escalated.String
StageThreeSettings > DurationSetting > DurationReminderProfileEnter the name of a reminder profile.String
StageThreeSettings > DurationSetting > DurationTypeEnter a duration type.EnumValid values:
Day
Week
StageThreeSettings > DurationSetting > EscalationTypeSpecify an escalation type.EnumValid values:
Notify
ReAssignTo
AutoReject
StageThreeSettings > EmailSetting > EnableNotifyApproverWhenAssignedSet to true if you want to notify the approver when the task is assigned.Boolean
StageThreeSettings > EmailSetting > NotifyApproverEmailTemplateEnter the name of an e-mail template that will be used to notify the approver when the task is assigned.String
StageThreeSettings > EmailSetting > EnableNotifyRequesterWhenApprovedSet to true if you want to notify the requester when the request is approved.Boolean
StageThreeSettings > EmailSetting > NotifyRequesterApprovedEmailTemplateEnter the name of an e-mail template that will be used to notify the requester when the request is approved.String
StageThreeSettings > EmailSetting > EnableNotifyRequesterWhenRejectedSet to true if you want to notify the requester when the request is rejected.Boolean
StageThreeSettings > EmailSetting > NotifyRequesterRejectedEmailTemplateEnter the name of an e-mail template that will be used to notify the requester when the request is rejected.String
StageThreeSettings > EmailSetting > EnableNotifyApproverWhenCancelledSet to true if you want to notify the approver and requester when the request is canceled.Boolean
StageThreeSettings > EmailSetting > NotifyApproverCancelledEmailTemplateEnter the name of an e-mail template that will be used to notify the requester and approver when the request is canceled.String
StageThreeSettings > EmailSetting > EnableNotifyApproverWhenRejectedSet to true if you want to notify all previous approvers when the request is rejected.Boolean
StageThreeSettings > EmailSetting > NotifyApproverRejectedEmailTemplateEnter the name of an e-mail template that will be used to notify all previous approvers when the request is rejected.String
StageSettings > EnableAutoApproveWhenRequesterIsApproverSet to true if you want to automatically approve the request when the requester and the approver are the same person.Boolean
StageSettings > EnableAutoApprovalSet to true if you want to enable automatic approval under certain conditions.Boolean
StageSettings > EnableAutoApproveWhenRequesterIn AutoApproveGroupSet to true if you want to automatically approve the request when the requester is a member of a specific group.Boolean
StageSettings > AutoApproveGroupEnter one or more group names.String collection
StageSettings > StageCountEnter a number to specify the approval stages.Int32Valid values:
0
1
2
3
CompletionEmailTemplateEnter the name of an e-mail template that will be used to send the request completion notification e-mail.String
DuplicateActionThis property value determines how to deal with the approval process if there is an existing approval process with the same name. Use the new name with a suffix automatically added to the original approval process name, or do not create the approval process during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the approval process with the same name, the existing approval process with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Approvalprocessname_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for this approval process.String
DescriptionEnter a description for this approval process.String

Group Renewal Profile

The following table shows the properties of a group renewal profile.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateGroupRenewalProfile. It indicates that the JSON file is used for the group renewal profile.Enum
EnableMembershipRenewalSet to true if you want to enable the membership renewal.Boolean
EnableOwnersRenewalSet to true if you allow renewal task assignees to review and modify group owners.Boolean
EnableMembersRenewalSet to true if you allow renewal task assignees to review and modify group members.Boolean
EnableAddOwnersSet to true if you want to allow renewal task assignees to add owners to the group during the renewal process.Boolean
EnableAddMembersSet to true if you allow renewal task assignees to add members to the group during the renewal process.Boolean
EnableMembershipOnlyExternalUsersSet to true if you allow renewal task assignees to only renew external users during the membership renewal process.Boolean
EnableAtLeastOwnersSet to true if you want to limit the minimum amount of required group owners.Boolean
EnableRemoveBlockedOwnersSet to true if you want to enable the recommended action for renewal task assignees to remove users who have been blocked from signing in Microsoft Entra.Boolean
EnableRemoveAdditionalPermissionSet to true if you want to enable the recommended action for renewal task assignees to remove all user permissions except owners and members.Boolean
EnableOnlyExternalUsersSet to true if you allow renewal task assignees to only renew external users.Boolean
EnableSharingLinksRenewalSet to true if you allow renewal task assignees to renew sharing links.Boolean
EnableAddUsersToSPGroupSet to true if you allow renewal task assignees to add users to SharePoint groups during the renewal process.Boolean
EnableRemoveGuestAccessSet to true if you want to enable the recommended action for renewal task assignees to remove all direct guest user access to high risk content.Boolean
EnableRemoveSharingLinksSet to true if you want to enable the recommended action for renewal task assignees to remove sharing links with external user access.Boolean
OwnersCountEnter a number to specify the minimum amount of required group owners.Int
CategoryEnter the name of a category that is used to organize the renewal profile.String
AdminContactSpecify an administrator contact who is responsible for the successful completion of the renewal process.String
CustomizeMessageList > CustomizedMessageValueEnter a message that will be displayed to the renewal task assignee, asking whether or not the login user is the correct person to perform the renewal action.String
CustomizeMessageList > isEnabledSet to true if you want to enable the language for the custom message.Boolean
CustomizeMessageList > LanguageDefine the language for the custom message shown to the renewal process assignee.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
DefaultLanguageSpecify a default language for the custom message shown to the renewal process assignee. Note that only the language whose property isEnabled is set to true can be set as the default language.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
ErrorTaskNotificationEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the renewal task encounters any errors.String
OverDueNotificationEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail when the renewal process is overdue.String
DurationEscalationSettings > SequenceEnter user roles or group names to assign users as the renewal task assignee.String collectionValid user roles:
$PrimaryGroupContact
$SecondaryGroupContact
$GroupOwners
$ManagerOfPrimaryGroupContact
$ManagerOfSecondaryGroupContact
DurationEscalationSettings > EnableReassignSet to true if you allow task assignees to reassign tasks to other users.Boolean
DurationEscalationSettings > EnableSkipProcessSet to true if you allow task assignees to state they are not responsible and are unsure who is responsible to complete the renewal process.Boolean
DurationEscalationSettings > NewTaskNotificationEmailTemplateEnter the name of an e-mail template that will be used to notify the assignee of the renewal task.String
DurationEscalationSettings > DurationSpecify a number as the amount of time for the duration for each process.Int32
DurationEscalationSettings > AssigneeOrderSpecify the renewal order for all renewal task assignees.EnumValid values:
0 (The renewal task assignees must complete the task one after another.)
1 (The renewal task will be assigned to all task assignees at the same time.)
DurationEscalationSettings > DurationTypeSpecify the unit of time for the duration.EnumValid values:
Day
Week
RecurrenceSettings > Weekly > IntervalEnter a number for the week interval to configure the weekly recurrent renewal process.Int32For example, enter 3 to set the interval as every 3 weeks.
RecurrenceSettings > Weekly > DayofWeekSpecify a specific day within a week to configure the weekly renewal processEnumValid values:
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
RecurrenceSettings > Daily > IntervalEnter a number for the day interval to configure the day interval.Int32For example, enter 90 to set the interval as every 90 days.
RecurrenceSettings > Monthly > IntervalEnter a number for the month interval to configure the monthly recurrent renewal process.Int32For example, enter 3 to set the interval as every 3 months.
RecurrenceSettings > Monthly > DayOfMonthSpecify a specific day within a month.Int32Enter an integer between 1 and 28 to specify a specific date in a month, or enter 32 to specify the last day of a month.
RecurrenceSettings > OrderWeekInMonth > OrderOfWeekSpecify the order of the day.EnumValid values:
First
Second
Third
Forth
Last
For example, the First Sunday of every 3 months.
RecurrenceSettings > OrderWeekInMonth > OrderWeekdayInMonthSpecify a specific day within a week.EnumValid values:
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
RecurrenceSettings > OrderWeekInMonth > OrderWeekMonthIntervalEnter a number for the month interval.Int32Enter 3 to set the interval as every 3 months.
RecurrenceSettings > ScheduleTypeSpecify the recurrence of the renewal process as Daily, Weekly, or Monthly.EnumValid values:
Day
Week
Month
OrderWeekInMonth
RecurrenceSettings > SpecifyFirstTaskGenerateTimeSet to true if you want to specify the time to generate the first renewal task.Boolean
RecurrenceSettings > FirstGeneratedTimeSpecify a specific date and time in UTC time as the first task generation time.DateTimeFor example, midnight UTC on January 1, 2020 is 2020-01-01 00:00:00.
RecurrenceSettings > RenewalScheduleTypeSpecify a method to configure the renewal schedule.EnumValid values:
Periodically (Configure a periodic renewal schedule.)
ManualDate (Manually specify each renewal task generation time.)
RecurrenceSettings > ManualScheduleDatesSpecify the renewal task generation time.String collectionFor example, 12-25_14:49.
Metadatas > NameEnter the metadata name.String
Metadatas > AssignByYou set a default value for the metadata or allow business users to assign the metadata value.EnumValid values:
BusinessUser (Business users can define the metadata value.)
BusinessUserWithRequired (Business users are required to define the metadata value.)
ITAdminWithReadOnly (IT administrator defines the metadata value and the value is shown as read-only to business users.)
ITAdminWithHide (IT administrator defines the metadata value and the value is not shown in the request form.)
SingleLineOrMultipleLineTypeValue > ValueEnter a default value for the metadata or enter multiple lines of text as the metadata value.String
LinkTypeValue > TitleEnter the desired text to be the hyperlink title.String
LinkTypeValue > AddressEnter the address of the hyperlink.String
ChoiceTypeValue > ValuesEnter the choices you wish to provide.String collection
UserProfileTypeValue > ValueEnter a username to get the user's property value from the user profile.String
AzureAdTypeValue > ValueEnter a username to get the user's property value from Microsoft Entra.String
UserTypeValue > ValuesEnter usernames or group names.String collection
ManagedTypeValue > ValuesEnter terms that have been configured in your SharePoint term store.String collection
YesOrNoTypeValue > ValueSpecify a default value for the metadata, true or false.Boolean
YesOrNoTypeValue > DefaultTermLanguageSpecify a default display language for the terms and conditions.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
YesOrNoTypeValue > EnableTermsSet to true if you want to enable the desired terms and conditions. Note that if you enable the terms and conditions agreement, only Yes can be the default value.Boolean
YesOrNoTypeValue > TermsAndConditions > LanguageSpecify a language for the terms and conditions.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
YesOrNoTypeValue > TermsAndConditions > TermDefine the terms and conditions.String
YesOrNoTypeValue > TermsAndConditions > TrueValueEnter your preferred value to replace Yes.String
YesOrNoTypeValue > TermsAndConditions > FalseValueEnter your preferred value to replace No.String
YesOrNoTypeValue > TermsAndConditions > IsEnableCustomValueSet to true if you change default terms and conditions metadata to your preferred values.Boolean
YesOrNoTypeValue > TermsAndConditions > IsEnabledSet to true if you want to enable the language for the terms and conditions.Boolean
EnableArchivalThis property is for team renewal. Set to false when you configure a group renewal profile.Boolean
EnableDeletionSet to true if you allow the renewal task assignee to delete the group.Boolean
EnableContactRenewalSet to true if you allow renewal task assignees to review and modify primary group contact and secondary group contact.Boolean
EnableNotifyNewContactSet to true if you want to notify the newly assigned contacts when task assignees select them as the new contacts.Boolean
NotifyNewContactEmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
EnableMetadataRenewalSet to true if you allow renewal task assignees to review and modify values of group metadata.Boolean
EnablePermissionRenewalSet to true if you allow renewal task assignees to review and modify user and SharePoint group permissions to the corresponding group team site.Boolean
RenewalChannelSetting > IsEnabledSet to true if you allow renewal task assignees to review and modify group related team's private channels.Boolean
RenewalChannelSetting > AssigneeEnter user roles to assign users as private channel task assignees.StringValid user roles:
$TeamsOwners
$TeamsContacts
$ChannelOwners
RenewalChannelSetting > NotifyAssigneeEmailTemplateEnter the name of an e-mail template that will be used to notify the assignee of the renewal task.String
RenewalChannelSetting > EnableOwnersRenewalSet to true if you allow renewal task assignees to review and modify private channel owners.Boolean
RenewalChannelSetting > EnableMembersRenewalSet to true if you allow renewal task assignees to review and modify private channel members.Boolean
RenewalChannelSetting > AllowAssigneeDeleteChannelSet to true if you allow private channel renewal task assignees to delete the private channel.Boolean
RenewalChannelSetting > AllowTeamAssigneeDeleteChannelSet to true if you allow the team renewal task assignee to delete the private channel.Boolean
RenewalChannelSetting > EnableTaskOverdueRemindSet to true if you want to send a reminder email to the renewal task assignees before the renewal process is overdue.Boolean
RenewalChannelSetting > TaskOverdueReminderProfileEnter the name of an e-mail template that will be used to send the overdue renewal process reminder email.String
RenewalChannelSetting > DefaultLanguageSpecify a default language for the custom message shown to the private channel renewal process assignee. Note that only the language whose property isEnabled is set to true and can be set as the default language.Enum
RenewalChannelSetting > CustomizedMessageList > CustomizedMessageValueEnter a message that will be displayed to the renewal task assignee.String
RenewalChannelSetting > CustomizedMessageList > isEnabledSet to true if you want to enable the language for the custom message.Boolean
RenewalChannelSetting > CustomizedMessageList > LanguageDefine the language for the custom message shown to the private channel renewal process assignee.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
DuplicateActionThis property value determines how to deal with the profile if there is an existing profile with the same name. Use the new name with a suffix automatically added to the original profile name, or do not create the profile during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the profile with the same name, the existing profile with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Profilename_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for the group renewal profile.String
DescriptionEnter the description of the group renewal profile.String

Reminder Profile

The following table shows the properties of a reminder profile.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateReminderProfile. It indicates that the JSON file is used for the reminder profile.Enum
EmailTemplateEnter the name of an e-mail template that will be used to send the notification e-mail.String
NotifyAdvanceIntervalEnter a number to define when to send the notification e-mail before the task expires.Int32
NotifyAdvanceIntervalTypeEnter a duration type as the unit of the duration.EnumValid values:
Day
Week
Month
EnableRecurrentRemindSet to true if you want to enable recurrent reminder to re-send the notification e-mail in schedule.Boolean
RecurrentReminderIntervalEnter a number to define the recurrent reminder schedule.Int32The unit of time is day.
DuplicateActionThis property value determines how to deal with the profile if there is an existing profile with the same name. Use the new name with a suffix automatically added to the original profile name, or do not create the profile during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the profile with the same name, the existing profile with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Profilename_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
CCSpecify users or groups (Microsoft 365 Groups, distribution groups, or mail-enabled security groups) who will receive a copy of the reminder e-mail before the task is overdue.String collectionLocal users or guest users are not allowed to be specified.
NameEnter a name for this reminder profile.String
DescriptionEnter a description for this reminder profile.String

Metadata

The following table shows the properties of metadata.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateMetadata. It indicates that the JSON file is used for metadata.Enum
TypeEnter the type of the metadata.EnumValid values:
SingleLineText
MultiLineText
YesOrNo
Choices
PeoplePickerValue
Hyperlink
AzureADProperty
DisplayTypeThis property value determines whether to display the metadata in reports. If you do not want to hide the metadata, define the reports where you want to display the metadata.EnumValid values:
Hide
DisplayInAllPlaces (Display the metadata in Public Site Collection Directory, My Sites report, and My Teams and Groups report)
OnlyDisplayInAdminReport (Display the metadata in Administration Reports)
OnlyDisplayInEndUserReport (Display the metadata when business users view workspaces in the Cloud Governance Portal)
AssignByYou assign the metadata value or allow business users to assign the metadata value.EnumValid values:
BusinessUser (Business users can assign the metadata value.)
BusinessUserWithRequired (Business users are required to assign the metadata value.)
ITAdminWithReadOnly (IT administrator assigns the metadata value and the metadata value is shown as read-only to business users.)
ITAdminWithHide (IT administrator assigns the metadata value and the metadata value is not shown in the request form.)
BooleanMetadataSettings > EnableTermsSet to true if you want to enable the desired terms and conditions. Note that if you enable terms and conditions agreement, only Yes can be the default value.Boolean
BooleanMetadataSettings > DefaultTermLanguageSpecify a default display language for the terms and conditions.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
BooleanMetadataSettings > ValueSet to true if you want the default value to be Yes.Boolean
BooleanMetadataSettings > TermsAndConditions > LanguageSpecify a language for the terms and conditions.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
BooleanMetadataSettings > TermsAndConditions > TermDefine the terms and conditions.String
BooleanMetadataSettings > TermsAndConditions > TrueValueEnter your preferred value to replace Yes.String
BooleanMetadataSettings > TermsAndConditions > FalseValueEnter your preferred value to replace No.String
BooleanMetadataSettings > TermsAndConditions > IsEnableCustomValueSet to true if you change default terms and conditions metadata to your preferred values.Boolean
BooleanMetadataSettings > TermsAndConditions > IsEnabledSet to true if you want to enable the language for the terms and conditions.Boolean
UserMetadataSettings > UsersEnter usernames or group names.String collection
UserMetadataSettings > AllowReferenceAsRoleInApprovalProcessSet to true if you want to allow the metadata to be referenced as a variable role that can be assigned as an approver in an approval process.Boolean
UserMetadataSettings > PeoplePickerFilterProfileSpecify a people picker profile whose settings will be applied to the metadata value field in the end user request form.
AzureAdMetadataSettings > TenantEnter a Microsoft 365 tenant name.String
AzureAdMetadataSettings > IsUseBuiltInPropertySet to true if you want to get value from Microsoft Entra built-in properties.Boolean
AzureAdMetadataSettings > PropertyEnter the name of a property whose value will be used as the metadata value.String
AzureAdMetadataSettings > TargetUserEnter usernames or certain user roles to specify users to get the user property value.StringValid user roles:
$Requester
$PrimarySiteCollectionContact
$SecondarySiteCollectionContact
$PrimaryGroupContact
$SecondaryGroupContact
AzureAdMetadataSettings > AllowReferenceAsRoleInApprovalProcessSet to true if you want to allow the metadata to be reference as a variable role that can be assigned as an approver in an approval process.Boolean
ChoiceMetadataSettings > ChoicesEnter the choices that you wish to provide.String collection
ChoiceMetadataSettings > ValuesEnter a default value for the metadata.String collection
ChoiceMetadataSettings > ChoiceTypeEnter the type of choices.EnumValid values:
DropDown
RadioButton
CheckBoxes
LinkMetadataSettings > TitleEnter your desired text as the hyperlink title.String
LinkMetadataSettings > AddressEnter the address of the hyperlink.String
SingleLineOrMultipleLineMetadataSettings > ValueEnter a default value for the metadata.String
SingleLineOrMultipleLineMetadataSettings > EnableTextValidationSet to true if you want to apply validation rule to metadata values on the request page.Boolean
SingleLineOrMultipleLineMetadataSettings > TextValidationRuleNameEnter a validation rule name.String
DuplicateActionThis property value determines how to deal with the metadata if there is an existing metadata with the same name. Use the new name with a suffix automatically added to the original metadata name, or do not create the metadata during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the metadata with the same name, the existing metadata with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Metadataname_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for the metadata.String
DescriptionEnter a description for the metadata.String
Content > IsEnabledChoose whether to enable display name and description in your desired languages. They are what your business users will see.Boolean
Content > DefaultLanguageSpecify a default language for the display name and description.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
Content > Contents > NameEnter a display name for the metadata.String
Content > Contents > LanguageDefine the language for the display name and description.EnumValid values:
English,
French,
Japanese,
Portuguese,
German,
Italian,
Chinese,
Spanish
Content > Contents > MessageEnter a description for business users.String
Content > Contents > IsEnabledSet to true if you want to enable the language for the display name and description.Boolean

Text Validation Rule

The following table shows the properties of a text validation rule.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateTextValidationRuleProfile. It indicates that the JSON file is used for the text validation rule.Enum
RegularExpressionEnter a regular expression for this rule.String
ErrorMessageDefine the message that will be displayed to the user once the entered content is invalid.String
ValidationTextEnter content that will be used to test the expected behavior of the entered regular expression.String
DuplicateActionThis property value determines how to deal with the rule if there is an existing rule with the same name. Use the new name with a suffix automatically added to the original rule name, or do not create the rule during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the rule with the same name, the existing rule with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Rulename_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for the text validation ruleString
DescriptionEnter a description for the text validation rule.String

Category

The following table shows the properties of a category.

PropertyDescriptionTypeNotes
TemplateTypeThis property value is CreateCategory. It indicates that the JSON file is used for the category management.Enum
EnglishDisplayNameEnter the category name in English.String
FrenchDisplayNameEnter the category name in French.String
JapaneseDisplayNameEnter the category name in Japanese.String
GermanDisplayNameEnter the category name in German.String
ItalianDisplayNameEnter the category name in Italian.String
DuplicateActionThis property value determines how to deal with the category if there is an existing category with the same name. Use the new name with a suffix automatically added to the original category name, or do not create the category during the import process.
If the service has been successfully imported into Cloud Governance and you choose to not create the category with the same name, the existing category with the same name will be applied to the service.
EnumValid values:
CreateNewWithSuffix (The format of the new name is Categoryname_1.)
Skip (This JSON file will not be imported into Cloud Governance.)
NameEnter a name for the category.String
DescriptionEnter a description for the category.String