10.26 Remove-DRAAssignments

Synopsis

Removes a delegation assignment from assistant administrators.

Syntax

Remove-DRAAssignments -Identifier <String> [-AssistantAdmin <String>] [-Roles <String[]>] [-Powers <String[]>] [-DRARestServer <String>] [-DRARestPort <Int32>] [-IgnoreCertificateErrors <SwitchParameter>] [-Force <SwitchParameter>] [-Timeout <Int32>] [<CommonParameters>]

Description

The Remove-DRAAssignments cmdlet removes an ActiveView assignment and any associated roles or powers from an assistant administrator or Assistant Admin group.

Parameters

Attribute / Description

Parameters / Values

Required

Position

Default Value

Accept Pipeline input?

Accept wildcard characters?

Identifier <String>

An existing ActiveView scope specified by name.

true

named

true (ByPropertyName)

false

AssistantAdmin [<String>]

A delegated assistant administrator or group, specified by a user or group distinguished name, or an Assistant Admin group name.

false

named

true (ByPropertyName)

false

Roles [<String>]

One or more delegated roles, specified by name or * for all assigned roles.

false

named

true (ByPropertyName)

false

Powers [<String>]

One or more delegated powers, specified by name or * for all assigned powers.

false

named

true (ByPropertyName)

false

DRARestServer [<String>]

The name of the computer running the DRA REST Service. The requested DRA operation will execute on this server. If the parameter is not specified, the value defaults to 'localhost'.

false

named

 

true (ByPropertyName)

false

DRARestPort [<Int32>]

The port number of the DRA REST Service. This parameter is only used when the DRARestServer parameter is also specified. If the parameter is not specified, the value defaults to 8755.

false

named

8755

true (ByPropertyName)

false

IgnoreCertificateErrors [<SwitchParameter>]

Allows the request to bypass any SSL certificate errors, such as the InvalidOperation error that occurs when the REST Service is bound to a self-signed certificate.

false

named

 

false

false

Force [<SwitchParameter>]

Suppresses any request for user input and supplies a 'yes' response. For example: -Force with a delete request will perform the delete without presenting the confirmation request to the user.

false

named

 

false

false

Timeout [<Int32>]

The number of seconds to wait before the request to the DRA REST server times out. To specify an infinite timeout, you can set this parameter to -1.

false

named

100 seconds

true (ByPropertyName)

false

<CommonParameters>

Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see About CommonParameters.

 

 

 

 

 

NOTE:For more information, type "Get-Help Remove-DRAAssignments -detailed". For technical information, type "Get-Help Remove-DRAAssignments -full".

Example 10-32 1

PS C:\>Remove-DRAAssignments -Identifier AV1 -AssistantAdmin "CN=MyUser,OU=Users,OU=ABC,OU=ABC-Parent,DC=MYDOMAIN,DC=corp" -Roles "Audit Users and Groups"

This example removes MyUser from the “AV1” ActiveView and from the “Audit Users and Groups” role. Using a * such as -Roles * or -Powers * will do a remove all.