Get-VMNetworkAdapterAcl

Gets the ACLs configured for a virtual machine network adapter.

Syntax

Get-VMNetworkAdapterAcl
   [[-VMName] <String[]>]
   [-VMNetworkAdapterName <String>]
   [-CimSession <CimSession[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential[]>]
   [<CommonParameters>]
Get-VMNetworkAdapterAcl
   [-VMSnapshot] <VMSnapshot>
   [<CommonParameters>]
Get-VMNetworkAdapterAcl
   [-VMNetworkAdapter] <VMNetworkAdapterBase[]>
   [<CommonParameters>]
Get-VMNetworkAdapterAcl
   [-ManagementOS]
   [-VMNetworkAdapterName <String>]
   [-CimSession <CimSession[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential[]>]
   [<CommonParameters>]
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

PS C:\> Get-VMNetworkAdapterAcl -VMName Redmond

Gets all the port ACLs configured on virtual machine Redmond.

Parameters

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

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

-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

-Credential

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Type:PSCredential[]
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
Aliases:VMCheckpoint
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Outputs

Microsoft.HyperV.PowerShell.VMNetworkAdapterAclSetting