Get-R1Aci

Get-R1Aci

SYNOPSIS

Returns access control instructions.

SYNTAX

All (Default)

Get-R1Aci [-baseDn <String>] [<CommonParameters>]

AciId

Get-R1Aci -aciId <Int64> -baseDn <String> [<CommonParameters>]

DESCRIPTION

Returns the access control instructions defined on the deployment.

With no parameters, the ACIs held at the root are returned. Specify baseDn for the ACIs held at an entry. Specify aciId together with the baseDn holding it to return a single ACI.

EXAMPLES

Example 1

Get-R1Aci

Returns every access control instruction.

Example 2

Get-R1Aci -baseDn 'cn=config'

Returns the access control instructions held at the specified DN.

Example 3

Get-R1Aci -aciId 12345 -baseDn 'cn=config'

Returns a single access control instruction.

PARAMETERS

-aciId

The identifier of the ACI, which the API derives as a hash of the ACI itself.

Type: Int64
Parameter Sets: AciId
Aliases:

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

-baseDn

The DN holding the ACI. Omit it for the ACIs held at the root.

Type: String
Parameter Sets: All
Aliases:

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

Type: String
Parameter Sets: AciId
Aliases:

Required: True
Position: Named
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.Int64

System.String

OUTPUTS

psRadiantOne.Aci

NOTES

An ACI held at the root cannot be returned on its own: the single read requires a DN, and an empty one is refused with HTTP 400. Return them with the listing instead.

RELATED LINKS