Skip to content

Latest commit

 

History

History
205 lines (156 loc) · 4.9 KB

Set-AzureADMSAdministrativeUnit.md

File metadata and controls

205 lines (156 loc) · 4.9 KB
external help file Module Name online version schema
Microsoft.Open.MS.GraphBeta.PowerShell.dll-Help.xml
AzureADPreview
2.0.0

Set-AzureADMSAdministrativeUnit

SYNOPSIS

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 or region is equal to United States.

PARAMETERS

-Description

Specifies a description.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisplayName

Specifies a display name.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
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
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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
Parameter Sets: (All)
Aliases: infa

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

-InformationVariable

Specifies an information variable.

Type: String
Parameter Sets: (All)
Aliases: iv

Required: False
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
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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
Parameter Sets: (All)
Aliases:

Required: False
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
Parameter Sets: (All)
Aliases:

Required: False
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
Parameter Sets: (All)
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Get-AzureADMSAdministrativeUnit

New-AzureADMSAdministrativeUnit

Remove-AzureADMSAdministrativeUnit