Export (0) Print
Expand All
Expand Minimize

Get-VMNetworkAdapterExtendedAcl

Windows Server 2012 R2 and Windows 8.1

Updated: June 10, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Get-VMNetworkAdapterExtendedAcl

Gets extended ACLs configured for a virtual network adapter.

Syntax

Parameter Set: VMName
Get-VMNetworkAdapterExtendedAcl [[-VMName] <String[]> ] [-ComputerName <String[]> ] [-VMNetworkAdapterName <String> ] [ <CommonParameters>]

Parameter Set: ManagementOS
Get-VMNetworkAdapterExtendedAcl -ManagementOS [-ComputerName <String[]> ] [-VMNetworkAdapterName <String> ] [ <CommonParameters>]

Parameter Set: ResourceObject
Get-VMNetworkAdapterExtendedAcl [-VMNetworkAdapter] <VMNetworkAdapterBase[]> [ <CommonParameters>]

Parameter Set: VMObject
Get-VMNetworkAdapterExtendedAcl [-VM] <VirtualMachine[]> [-VMNetworkAdapterName <String> ] [ <CommonParameters>]

Parameter Set: VMSnapshot
Get-VMNetworkAdapterExtendedAcl [-VMSnapshot] <VMSnapshot> [ <CommonParameters>]




Detailed Description

The Get-VMNetworkAdapterExtendedAcl cmdlet gets the extended access control lists (ACLs) configured for a virtual network adapter. If an ACL applies to both inbound and outbound packets, it appears in both inbound and outbound lists.

Parameters

-ComputerName<String[]>

Specifies an array of Hyper-V hosts. The cmdlet gets the ACLs associated with the virtual network adapters on the Hyper-V hosts that you specify.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ManagementOS

Indicates that the cmdlet operates on the parent or host operating system. If you specify this parameter, this cmdlet gets ACLs associated with network adapters in the parent or host operating system.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VM<VirtualMachine[]>

Specifies an array of virtual machines as VirtualMachine objects. The cmdlet gets ACLs for network adapters that belong to the virtual machines that you specify. To obtain a virtual machine object, use the Get-VM cmdlet.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMName<String[]>

Specifies an array of names of VMs. The cmdlet gets ACLs associated with network adapters that belong to the VMs that you specify.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMNetworkAdapter<VMNetworkAdapterBase[]>

Specifies an array of virtual network adapter objects. The cmdlet gets ACLs associated with the adapters that you specify. To obtain a network adapter, use the Get-VMNetworkAdapter cmdlet.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMNetworkAdapterName<String>

Specifies the name of a virtual network adapter. The cmdlet gets extended ACLs associated with the adapter that you specify.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMSnapshot<VMSnapshot>

Specifies a snapshot as a VMSnapshot object. The cmdlet gets ACLs for network adapters that belong to the snapshot that you specify. To obtain a snapshot, use the Get-VMSnapshot cmdlet.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.HyperV.PowerShellMicrosoft.HyperV.PowerShell.VMNetworkAdapterExtendedAclSetting

Examples

Example 1: Get all extended ACLs

This command gets all the extended ACLs for the virtual machine named TSQA01.


PS C:\> Get-VMNetworkAdapterExtendedAcl -VMName "TSQA01" 

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft