你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzNetworkWatcherConnectionMonitor

更新连接监视器资源。

语法

SetByName (默认值)

Set-AzNetworkWatcherConnectionMonitor
    -NetworkWatcherName <String>
    -ResourceGroupName <String>
    -Name <String>
    -SourceResourceId <String>
    -DestinationPort <Int32>
    [-MonitoringIntervalInSeconds <Int32>]
    [-SourcePort <Int32>]
    [-DestinationResourceId <String>]
    [-DestinationAddress <String>]
    [-ConfigureOnly]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResource

Set-AzNetworkWatcherConnectionMonitor
    -NetworkWatcher <PSNetworkWatcher>
    -Name <String>
    -SourceResourceId <String>
    -DestinationPort <Int32>
    [-MonitoringIntervalInSeconds <Int32>]
    [-SourcePort <Int32>]
    [-DestinationResourceId <String>]
    [-DestinationAddress <String>]
    [-ConfigureOnly]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceV2

Set-AzNetworkWatcherConnectionMonitor
    -NetworkWatcher <PSNetworkWatcher>
    -Name <String>
    -TestGroup <PSNetworkWatcherConnectionMonitorTestGroupObject[]>
    [-Output <PSNetworkWatcherConnectionMonitorOutputObject[]>]
    [-Note <String>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByNameV2

Set-AzNetworkWatcherConnectionMonitor
    -NetworkWatcherName <String>
    -ResourceGroupName <String>
    -Name <String>
    -TestGroup <PSNetworkWatcherConnectionMonitorTestGroupObject[]>
    [-Output <PSNetworkWatcherConnectionMonitorOutputObject[]>]
    [-Note <String>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByLocation

Set-AzNetworkWatcherConnectionMonitor
    -Location <String>
    -Name <String>
    -SourceResourceId <String>
    -DestinationPort <Int32>
    [-MonitoringIntervalInSeconds <Int32>]
    [-SourcePort <Int32>]
    [-DestinationResourceId <String>]
    [-DestinationAddress <String>]
    [-ConfigureOnly]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByLocationV2

Set-AzNetworkWatcherConnectionMonitor
    -Location <String>
    -Name <String>
    -TestGroup <PSNetworkWatcherConnectionMonitorTestGroupObject[]>
    [-Output <PSNetworkWatcherConnectionMonitorOutputObject[]>]
    [-Note <String>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceId

Set-AzNetworkWatcherConnectionMonitor
    -ResourceId <String>
    -SourceResourceId <String>
    -DestinationPort <Int32>
    [-MonitoringIntervalInSeconds <Int32>]
    [-SourcePort <Int32>]
    [-DestinationResourceId <String>]
    [-DestinationAddress <String>]
    [-ConfigureOnly]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdV2

Set-AzNetworkWatcherConnectionMonitor
    -ResourceId <String>
    -TestGroup <PSNetworkWatcherConnectionMonitorTestGroupObject[]>
    [-Output <PSNetworkWatcherConnectionMonitorOutputObject[]>]
    [-Note <String>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByInputObject

Set-AzNetworkWatcherConnectionMonitor
    -InputObject <PSConnectionMonitorResult>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzNetworkWatcherConnectionMonitor cmdlet 更新连接监视器资源。

示例

示例 1:更新连接监视器

Set-AzNetworkWatcherConnectionMonitor -Location centraluseuap -Name cm -SourceResourceId /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RgCentralUSEUAP/providers/Microsoft.Compute/virtualMachines/vm `
-DestinationAddress google.com -DestinationPort 80 -Tag @{"key1" = "value1"}
Name                        : cm
Id                          : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGro
                              ups/NetworkWatcherRG/providers/Microsoft.Network/networkWatcher
                              s/NetworkWatcher_centraluseuap/connectionMonitors/cm
Etag                        : W/"5b2b20e8-0ce0-417e-9607-76208149bb67"
ProvisioningState           : Succeeded
Source                      : {
                                "ResourceId": "/subscriptions/00000000-0000-0000-0000-0000000
                                00000/RgCentralUSEUAP/providers/Microsoft.Compute/virtualMach
                                ines/vm",
                                "Port": 0
                              }
Destination                 : {
                                "Address": "google.com",
                                "Port": 80
                              }
MonitoringIntervalInSeconds : 60
AutoStart                   : True
StartTime                   : 1/12/2018 7:19:28 PM
MonitoringStatus            : Running
Location                    : centraluseuap
Type                        : Microsoft.Network/networkWatchers/connectionMonitors
Tags                        : {
                                "key1": "value1"
                              }

在此示例中,我们通过更改 destinationAddress 并添加标记来更新现有连接监视器。

参数

-AsJob

在后台运行 cmdlet

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConfigureOnly

配置连接监视器,但不要启动它

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DestinationAddress

连接监视器目标(IP 或域名)的地址。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DestinationPort

连接监视器使用的目标端口。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DestinationResourceId

连接监视器用作目标的资源的 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

连接监视器对象。

参数属性

类型:PSConnectionMonitorResult
默认值:None
支持通配符:False
不显示:False

参数集

SetByInputObject
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Location

网络观察程序的位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByLocation
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocationV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MonitoringIntervalInSeconds

监视间隔(以秒为单位)。 默认值为 60 秒。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

连接监视器名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:ConnectionMonitorName

参数集

SetByName
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocationV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NetworkWatcher

网络观察程序资源。

参数属性

类型:PSNetworkWatcher
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceV2
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NetworkWatcherName

网络观察程序的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Note

与连接监视器关联的注释。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocationV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceIdV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Output

描述连接监视器输出目标。

参数属性

类型:

PSNetworkWatcherConnectionMonitorOutputObject[]

默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocationV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceIdV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

网络观察程序资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceId

ConnectionMonitor 资源 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
SetByResourceIdV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SourcePort

连接监视器使用的源端口。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SourceResourceId

连接监视器用作源的资源的 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Tag

表示资源标记的哈希表。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

SetByName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocation
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocationV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByResourceIdV2
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TestGroup

测试组的列表。

参数属性

类型:

PSNetworkWatcherConnectionMonitorTestGroupObject[]

默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByNameV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
SetByLocationV2
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSNetworkWatcher

String

PSConnectionMonitorResult

输出

PSConnectionMonitorResultV1

PSConnectionMonitorResultV2