편집

다음을 통해 공유

Set-NetIntent

Module:
NetworkATC Module

Allows provisioning of override values for the given network intent.

Syntax

ComputerName (Default) 

Set-NetIntent
    [-Name] <String>
    [[-ComputerName] <String>]
    [-AdapterPropertyOverrides <NetAdapterAdvancedConfiguration>]
    [-QoSPolicyOverrides <QoSPolicy>]
    [-AdapterRssOverrides <RssConfiguration>]
    [-SwitchOverrides <SwitchConfigurationOverride>]
    [-StorageOverrides <NetAdapterStorageOverride>]
    [-SiteOverrides <SiteConfiguration[]>]
    [-StorageVlans <Int32[]>]
    [-ManagementVlan <Int32>]
    [-Wait]
    [<CommonParameters>]

Cluster 

Set-NetIntent
    [-Name] <String>
    [-ClusterName] <String>
    [-AdapterPropertyOverrides <NetAdapterAdvancedConfiguration>]
    [-QoSPolicyOverrides <QoSPolicy>]
    [-AdapterRssOverrides <RssConfiguration>]
    [-SwitchOverrides <SwitchConfigurationOverride>]
    [-StorageOverrides <NetAdapterStorageOverride>]
    [-SiteOverrides <SiteConfiguration[]>]
    [-StorageVlans <Int32[]>]
    [-ManagementVlan <Int32>]
    [-Wait]
    [<CommonParameters>]

Global 

Set-NetIntent
    [[-ComputerName] <String>]
    [[-ClusterName] <String>]
    [-GlobalProxyOverrides <WinHttpAdvProxy>]
    [-GlobalClusterOverrides <ClusterSettings>]
    [-Wait]
    [<CommonParameters>]

Description

The Set-NetIntent cmdlet allows provisioning of override values for given network intents. All properties inside the override objects are nullable, meaning only the properties which are set will be applied.

Examples

Example 1

$adapterOverrides = @{
    JumboPacket = 9000
    InterruptModeration = "Enabled"
}
$qosOverrides = @{
    Name = "HighPriority"
    Priority = 1
    BandwidthPercentage = 50
}
$params = @{
    Name                     = "MyIntent"
    ComputerName             = "Server01"
    AdapterPropertyOverrides = $adapterOverrides
    QoSPolicyOverrides       = $qosOverrides
}
Set-NetIntent @params

This example sets the network intent named MyIntent on the computer Server01 with specified adapter property overrides and QoS policy overrides.

Parameters

-AdapterPropertyOverrides

Specifies the overrides for network adapter properties.

Parameter properties

Type:NetAdapterAdvancedConfiguration
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AdapterRssOverrides

Specifies the overrides for Receive Side Scaling (RSS) configuration on network adapters.

Parameter properties

Type:RssConfiguration
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClusterName

Specifies the name of the cluster on which the network intent should be set.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Cluster
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ComputerName

Specifies the name of the computer on which the network intent should be set.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Global
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GlobalClusterOverrides

Specifies the global overrides for cluster settings.

Parameter properties

Type:ClusterSettings
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Global
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GlobalProxyOverrides

Specifies the global overrides for proxy settings.

Parameter properties

Type:WinHttpAdvProxy
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Global
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ManagementVlan

Specifies the VLAN for management traffic.

Parameter properties

Type:Int32
Default value:-1
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of the network intent to be set.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-QoSPolicyOverrides

Specifies the overrides for Quality of Service (QoS) policies.

Parameter properties

Type:QoSPolicy
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteOverrides

Specifies the overrides for site configuration.

Parameter properties

Type:

SiteConfiguration[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageOverrides

Specifies the overrides for storage-related network adapter properties.

Parameter properties

Type:NetAdapterStorageOverride
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageVlans

Specifies the VLANs for storage networks.

Parameter properties

Type:

Int32[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SwitchOverrides

Specifies the overrides for network switch configuration.

Parameter properties

Type:SwitchConfigurationOverride
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Wait

Indicates that the cmdlet should wait for the operation to complete before returning control to the command line.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

Once the request has been successfully placed, all services will eventually detect and apply the updated override policies. Use Get-NetIntentStatus to see the current status. This may take several minutes to retrieve.

To force policy updates, use the Set-NetIntentRetryState to put a given policy in a retry pending state in which case the policy will be forcefully applied.