COMMAND EVERYTHING.

Add-NetIntent

Configures the network host using intent-based tags for adapters.

Networking / Security · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft NetworkATC reference: Configures the network host using intent-based tags for adapters. 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.

Add-NetIntent [[-ComputerName] <String>] -AdapterName <String[]> -Name <String> [-Wait] [-Compute]
 [-Management] [-Storage] [-Switchless] [-Stretch]
 [-AdapterPropertyOverrides <NetAdapterAdvancedConfiguration>] [-QoSPolicyOverrides <QoSPolicy>]
 [-AdapterRssPropertyOverrides <RssConfiguration>]
 [-SwitchPropertyOverrides <SwitchConfigurationOverride>]
 [-StorageOverrides <NetAdapterStorageOverride>] [-SiteOverrides <SiteConfiguration[]>]
 [-StorageVlans <Int32[]>] [-ManagementVlan <Int32>] [-SkipNetworkInterfaceValidation]
 [-PutGlobal <Boolean>] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for Add-NetIntent. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / NetworkATC · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-AdapterName (required): Specifies one or more physical network adapter names on which the network intent will be applied.
-AdapterPropertyOverrides: Allows you to specify a custom set of advanced property values for the network adapter(s), overriding the default settings applied by the intent.
-AdapterRssPropertyOverrides: Allows you to provide custom overrides for Receive Side Scaling (RSS) configurations on the network adapter(s).
-ClusterName (required): Specifies the name of the cluster for which the network intent is being defined. When used, the intent "floats" across the cluster. Any node with matching physical adapter names will automatically apply the intended configuration.
-Compute: Indicates that the network intent includes configuration related to compute workloads.
-ComputerName: Specifies the computer name of the target host on which the network intent configuration will be applied. For standalone hosts, use the local computer name; for scenarios where the script is executed remotely, ensure the current user has administrative privileges on the target machine.
-GlobalClusterOverrides: Allows you to provide cluster-wide configuration overrides that replace the default cluster settings.
-GlobalProxyOverrides: Used with global intents, this parameter allows you to override the default HTTP proxy settings with custom proxy configurations.
-Management: Designates that the network intent includes configuration for management traffic.
-ManagementVlan: Specifies the VLAN ID for management traffic. When set, network management tasks (administrative traffic) are aligned with the designated VLAN. The default value of –1 indicates that no specific VLAN is used unless explicitly defined.
-Name (required): Defines a unique name that identifies the network intent. Since intents are uniquely determined by their list of physical adapters, the name is used as an identifier to ensure that each intent is distinct.
-PutGlobal: Determines whether the network intent should be registered or persisted globally. When set to $true (the default), the intent is applied to the global repository, making it visible across the cluster. If $false, the intent is only updated locally and not propagated to the global context.
-QoSPolicyOverrides: Provides the ability to supply custom Quality of Service (QoS) policy settings that override the defaults.
-SiteOverrides: Allows you to apply site-specific configuration overrides for different physical or logical sites.
-SkipNetworkInterfaceValidation: If specified, the command bypasses the standard validation checks for network interfaces. This might be required in environments where non-standard or virtual interfaces are in use.
-Storage: Signals that the network intent includes storage-specific settings.
-StorageOverrides: Enables custom override settings specific to storage adapter configurations. Use this parameter to replace default storage network settings with those that better suit your storage traffic.
-StorageVlans: Specifies an array of VLAN IDs that should be used for storage traffic.
-Stretch: Enables stretch mode, allowing the network configuration to extend across multiple physical networks or sites. This option is useful for environments that require network intents to span more than one location or subnet.
-SwitchPropertyOverrides: Provides custom configuration overrides for virtual switch properties. These settings allow you to fine-tune the behavior of the virtual switch that might be created as part of the network intent, replacing the default switch configurations as needed.
-Switchless: Indicates that the configuration should be applied without creating a virtual switch. This mode is used when you want to configure the physical adapters directly without introducing additional switch constructs.
-Wait: When specified, the command will wait for the network configuration commands to complete or for status confirmation before returning control.

Prerequisites

Windows with the NetworkATC 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 cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

EXAMPLE 1

Add-NetIntent –AdapterName "Ethernet0" –ComputerName "Server01" –Name "MyIntent" -Compute

This example creates a new Compute intent for the standalone device named Server01 on network adapter Ethernet0. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/NetworkATC/Add-NetIntent.md

https://learn.microsoft.com/powershell/module/networkatc/add-netintent?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands

Get-NetIPInterface

Add-MpPreference

Get-MpPerformanceReport

Add-DhcpServerInDC