Get-VMNetworkAdapterAcl
Gets the ACLs configured for a virtual machine network adapter.
Syntax
Get-VMNetworkAdapterAcl
[[-VMName] <String[]>]
[-VMNetworkAdapterName <String>]
[-ComputerName <String[]>]
[<CommonParameters>]
Get-VMNetworkAdapterAcl
[-VMSnapshot] <VMSnapshot>
[<CommonParameters>]
Get-VMNetworkAdapterAcl
[-VMNetworkAdapter] <VMNetworkAdapterBase[]>
[<CommonParameters>]
Get-VMNetworkAdapterAcl
[-ManagementOS]
[-VMNetworkAdapterName <String>]
[-ComputerName <String[]>]
[<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
-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 |
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for