Get-VMNetworkAdapterAcl

Module:

Hyper-V

Gets the ACLs configured for a virtual machine network adapter.

Syntax

PowerShell

Get-VMNetworkAdapterAcl
   [[-VMName] <String[]>]
   [-VMNetworkAdapterName <String>]
   [-ComputerName <String[]>]
   [<CommonParameters>]

PowerShell

Get-VMNetworkAdapterAcl
   [-VMSnapshot] <VMSnapshot>
   [<CommonParameters>]

PowerShell

Get-VMNetworkAdapterAcl
   [-VMNetworkAdapter] <VMNetworkAdapterBase[]>
   [<CommonParameters>]

PowerShell

Get-VMNetworkAdapterAcl
   [-ManagementOS]
   [-VMNetworkAdapterName <String>]
   [-ComputerName <String[]>]
   [<CommonParameters>]

PowerShell

Get-VMNetworkAdapterAcl
   [-VMNetworkAdapterName <String>]
   [-VM] <VirtualMachine[]>
   [<CommonParameters>]

Description

The Get-VMNetworkAdapterAcl cmdlet gets the ACLs configured for a virtual machine network adapter. If an ACL entry is created to be applied to both directions, it will appear under the list of entries for the inbound direction and under the list of entries for the outbound direction in the output from Get-VMNetworkAdapterAcl.

Examples

Example 1

PowerShell

PS C:\>Get-VMNetworkAdapterAcl -VMName Redmond

Gets all the port ACLs configured on virtual machine Redmond.

Parameters

-ComputerName

Specifies one or more Hyper-V hosts on which the ACLs configured for a virtual machine network adapter are to be retrieved. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer - use "localhost" or a dot (".") to specify the local computer explicitly.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagementOS

Specifies that the ACLs are to be configured in the management (i.e. the parent, or host) operating system.

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

-VM

Specifies the virtual machine in which the ACLs configured for a virtual machine network adapter are to be retrieved.

Type:	VirtualMachine[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Specifies the name of the virtual machine in which the ACLs configured for a virtual machine network adapter are to be retrieved.

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMNetworkAdapter

Specifies the virtual network adapter for which the configured ACLs are to be retrieved.

Type:	VMNetworkAdapterBase[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMNetworkAdapterName

Specifies the virtual network adapter name for which the configured ACLs are to be retrieved.

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

-VMSnapshot

Specifies the snapshot in which the ACLs configured for a virtual machine network adapter are to be retrieved.

Type:	VMSnapshot
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False