Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
164 lines (127 sloc) 4.06 KB
ms.mktglfcycl ms.sitesec ms.author author description external help file keywords manager ms.date ms.prod ms.technology ms.topic online version schema title ms.assetid
manage
library
coreyp
coreyp-at-msft
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
Microsoft.NetworkController.Powershell.dll-help.xml
powershell, cmdlet
jasgro
12/20/2016
w10
powershell-windows
reference
2.0.0
Get-NetworkControllerAccessControlListRule
7D5ACAC1-07CF-4603-8F83-06DAF8ED952F

Get-NetworkControllerAccessControlListRule

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

RELATED LINKS

New-NetworkControllerAccessControlListRule