Set-R1AccessControlSetting

SYNOPSIS

Updates the access control settings.

SYNTAX

Set-R1AccessControlSetting [[-enableAci] <Boolean>] [[-allowAnonAccess] <Boolean>]
 [[-allowRootUserImpersonateOthers] <Boolean>] [[-allowAnonLegacyBehavior] <Boolean>]
 [[-bindReqPassword] <Boolean>] [[-enableNestedGroups] <Boolean>] [[-enableRootDseAci] <Boolean>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Updates the authorization settings held in access control settings.

The current settings are retrieved before they are updated, and sent back with the supplied values applied over them, so a setting left unspecified keeps its current value. The command therefore issues a GET followed by a PUT.

Because the command retrieves the settings before updating them, the account needs permission to read them as well as to change them.

EXAMPLES

Example 1

Set-R1AccessControlSetting -enableAci $true

Enables enforcement of access control instructions, leaving every other setting as it is.

Example 2

Set-R1AccessControlSetting -allowAnonAccess $false -enableNestedGroups $true

Disables anonymous access and enables nested group evaluation.

PARAMETERS

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-allowAnonAccess

Whether anonymous access is permitted.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-allowAnonLegacyBehavior

Whether the legacy anonymous access behaviour applies.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-allowRootUserImpersonateOthers

Whether the root user may impersonate other users.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-bindReqPassword

Whether a bind requires a password.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-enableAci

Whether access control instructions are enforced.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-enableNestedGroups

Whether nested groups are evaluated when applying access control.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-enableRootDseAci

Whether access control instructions are enforced on the root DSE.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 6
Default value: None
Accept pipeline input: True (ByPropertyName)
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

System.Boolean

OUTPUTS

System.Void

NOTES