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 RedmondGets 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