Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Get-NetworkControllerAccessControlListRule

Last Updated: 4/18/2017

SYNOPSIS

Gets a rule from an access control list for a network controller.

SYNTAX

Get-NetworkControllerAccessControlListRule [-AccessControlListId] <String[]> [[-ResourceId] <String[]>]
 -ConnectionUri <Uri> [-CertificateThumbprint <String>] [-Credential <PSCredential>] [-PassInnerException]
 [<CommonParameters>]

DESCRIPTION

The Get-NetworkControllerAccessControlListRule cmdlet gets a rule from an access control list for a network controller.

EXAMPLES

Example 1

This example retrieves all rules belonging to an Access Control List named Subnet1Acl from the Network Controller.

Get-NetworkControllerAccessControlListRule -ConnectionUri https://networkcontroller -AccessControlListId "Subnet1ACL"

PARAMETERS

-AccessControlListId

Specifies the ID of the Access Control List where the rule belongs.

Type: String[]
Parameter Sets: (All)
Aliases: 

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

-CertificateThumbprint

Specifies the certificate thumbprint of a digital public key X.509 certificate of a user account that has permission to perform this action. In order for Network Controller to authorize the account, specify this thumbprint by using the ClientCertificateThumbprint parameter of the Install-NetworkController or Set-NetworkController cmdlet.

Type: String
Parameter Sets: (All)
Aliases: 

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

-ConnectionUri

Specifies the Uniform Resource Identifier (URI) of the network controller that all Representational State Transfer (REST) clients use to connect to that controller.

Type: Uri
Parameter Sets: (All)
Aliases: 

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

-Credential

Specifies a user credential that has permission to perform this action. The default is the current user. Specify this parameter only if you run this cmdlet on a computer that is not part of the Network Controller cluster.

Type: PSCredential
Parameter Sets: (All)
Aliases: 

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

-PassInnerException

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-ResourceId

Specifies the resource ID of the ACL rule to get.

Type: String[]
Parameter Sets: (All)
Aliases: 

Required: False
Position: 1
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

Each rule has the following output:

  1. Name
  2. Protocol
  3. Source and destination port range
  4. Source and destination IP address prefix
  5. Action on the rule (Allow/Deny)
  6. Priority of rule
  7. Type of rule (inbound/outbound)
  8. Whether logging is enabled/disabled on the rule

NOTES

New-NetworkControllerAccessControlListRule

© 2017 Microsoft