Get-VMNetwork
Adapter
Acl
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.
Required Parameters
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | True (ByValue) |
Accept wildcard characters: | False |
Specifies the virtual network adapter for which the configured ACLs are to be retrieved.
Type: | VMNetworkAdapterBase[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True (ByValue) |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | True (ByValue) |
Accept wildcard characters: | False |
Optional Parameters
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | True (ByValue) |
Accept wildcard characters: | False |
Specifies the virtual network adapter name for which the configured ACLs are to be retrieved.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |