Set-AzureADMSAdministrativeUnit

Reference

Module:: AzureADPreview

Updates an administrative unit.

Syntax

Set-AzureADMSAdministrativeUnit
   -Id <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-Description <String>]
   [-DisplayName <String>]
   [-IsMemberManagementRestricted <Boolean>]
   [-MembershipRule <String>]
   [-MembershipRuleProcessingState <String>]
   [-MembershipType <String>]
   [<CommonParameters>]

Description

The Set-AzureADMSAdministrativeUnit cmdlet updates an administrative unit in Azure Active Directory (AD).

Examples

Example 1

PS C:\> Set-AzureADMSAdministrativeUnit -Id $adminUnit.Id -MembershipType "Dynamic" -MembershipRuleProcessingState "On" -MembershipRule '(user.country -eq "United States")'

Given an existing administrative unit referenced by $adminUnit, sets the membership type to dynamic and creates a membership rule to include all users whose country is equal to United States.

Parameters

-Description

Specifies a description.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Specifies a display name.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Specifies the ID of an administrative unit in Azure AD.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InformationAction

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

Continue
Ignore
Inquire
SilentlyContinue
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Specifies an information variable.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsMemberManagementRestricted

Indicates whether the management rights on resources in the administrative units should be restricted to ONLY the administrators scoped on the AU object.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MembershipRule

Specifies the membership rule for a dynamic administrative unit.

For more information about the rules that you can use for dynamic administrative units and dynamic groups, see Using attributes to create advanced rules.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MembershipRuleProcessingState

Specifies the rule processing state. The acceptable values for this parameter are:

"On". Process the group rule.
"Paused". Stop processing the group rule.

Changing the value of the processing state does not change the members list of the administrative unit.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MembershipType

Specifies whether the membership of this administrative unit is controlled dynamically or by manual assignment. The acceptable values for this parameter are:

Assigned
Dynamic

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False