Get-VMNetworkAdapterExtendedAcl
Gets extended ACLs configured for a virtual network adapter.
Syntax
Get-VMNetworkAdapterExtendedAcl
[[-VMName] <String[]>]
[-VMNetworkAdapterName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[<CommonParameters>] Get-VMNetworkAdapterExtendedAcl
[-VMSnapshot] <VMSnapshot>
[<CommonParameters>] Get-VMNetworkAdapterExtendedAcl
[-VMNetworkAdapter] <VMNetworkAdapterBase[]>
[<CommonParameters>] Get-VMNetworkAdapterExtendedAcl
[-ManagementOS]
[-VMNetworkAdapterName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[<CommonParameters>] Get-VMNetworkAdapterExtendedAcl
[-VMNetworkAdapterName <String>]
[-VM] <VirtualMachine[]>
[<CommonParameters>] Description
The Get-VMNetworkAdapterExtendedAcl cmdlet gets the extended access control lists (ACLs) configured for a virtual network adapter. If an ACL applies to both inbound and outbound packets, it appears in both inbound and outbound lists.
Examples
Example 1: Get all extended ACLs
PS C:\> Get-VMNetworkAdapterExtendedAcl -VMName "TSQA01"This command gets all the extended ACLs for the virtual machine named TSQA01.
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 an array of Hyper-V hosts. The cmdlet gets the ACLs associated with the virtual network adapters on the Hyper-V hosts that you specify.
| 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
Indicates that the cmdlet operates on the parent or host operating system. If you specify this parameter, this cmdlet gets ACLs associated with network adapters in 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 an array of virtual machines as VirtualMachine objects. The cmdlet gets ACLs for network adapters that belong to the virtual machines that you specify. To obtain a virtual machine object, use the Get-VM cmdlet.
| Type: | VirtualMachine[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
Specifies an array of names of VMs. The cmdlet gets ACLs associated with network adapters that belong to the VMs that you specify.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMNetworkAdapter
Specifies an array of virtual network adapter objects. The cmdlet gets ACLs associated with the adapters that you specify. To obtain a network adapter, use the Get-VMNetworkAdapter cmdlet.
| Type: | VMNetworkAdapterBase[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMNetworkAdapterName
Specifies the name of a virtual network adapter. The cmdlet gets extended ACLs associated with the adapter that you specify.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMSnapshot
Specifies a snapshot as a VMSnapshot object. The cmdlet gets ACLs for network adapters that belong to the snapshot that you specify. To obtain a snapshot, use the Get-VMSnapshot cmdlet.
| Type: | VMSnapshot |
| Aliases: | VMCheckpoint |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Inputs
None
Outputs
Microsoft.HyperV.PowerShell.VMNetworkAdapterExtendedAclSetting