Gets extended ACLs configured for a virtual network adapter.
Windows Server · Risk: Low · Documentation Verified
Last verified: 2026-10-26
Microsoft Hyper-V reference: Gets extended ACLs configured for a virtual network adapter. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.
Use an account with the target resource permissions documented for Get-VMNetworkAdapterExtendedAcl. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.
Supported environments
Windows / Hyper-V · Windows Server 2025 documentation; feature/module prerequisites apply
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.
-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.
-Credential
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
-ManagementOS (required)
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.
-VM (required)
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.
-VMName
Specifies an array of names of VMs. The cmdlet gets ACLs associated with network adapters that belong to the VMs that you specify.
-VMNetworkAdapter (required)
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.
-VMNetworkAdapterName
Specifies the name of a virtual network adapter. The cmdlet gets extended ACLs associated with the adapter that you specify.
-VMSnapshot (required)
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.
Prerequisites
Windows with the Hyper-V module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.
Security considerations
This is a read-oriented cmdlet; protect any sensitive results and check the documented effects of your selected parameters.
Examples
Example 1: Get all extended ACLs
Get-VMNetworkAdapterExtendedAcl -VMName "TSQA01"
This command gets all the extended ACLs for the virtual machine named TSQA01. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.