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

New-AzActionGroup

创建新的操作组或更新现有操作组。

语法

New-AzActionGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-ArmRoleReceiver <IArmRoleReceiver[]>]
   [-AutomationRunbookReceiver <IAutomationRunbookReceiver[]>]
   [-AzureAppPushReceiver <IAzureAppPushReceiver[]>]
   [-AzureFunctionReceiver <IAzureFunctionReceiver[]>]
   [-EmailReceiver <IEmailReceiver[]>]
   [-Enabled]
   [-EventHubReceiver <IEventHubReceiver[]>]
   [-GroupShortName <String>]
   [-ItsmReceiver <IItsmReceiver[]>]
   [-LogicAppReceiver <ILogicAppReceiver[]>]
   [-SmsReceiver <ISmsReceiver[]>]
   [-Tag <Hashtable>]
   [-VoiceReceiver <IVoiceReceiver[]>]
   [-WebhookReceiver <IWebhookReceiver[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzActionGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzActionGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzActionGroup
   -InputObject <IActionGroupIdentity>
   -Location <String>
   [-ArmRoleReceiver <IArmRoleReceiver[]>]
   [-AutomationRunbookReceiver <IAutomationRunbookReceiver[]>]
   [-AzureAppPushReceiver <IAzureAppPushReceiver[]>]
   [-AzureFunctionReceiver <IAzureFunctionReceiver[]>]
   [-EmailReceiver <IEmailReceiver[]>]
   [-Enabled]
   [-EventHubReceiver <IEventHubReceiver[]>]
   [-GroupShortName <String>]
   [-ItsmReceiver <IItsmReceiver[]>]
   [-LogicAppReceiver <ILogicAppReceiver[]>]
   [-SmsReceiver <ISmsReceiver[]>]
   [-Tag <Hashtable>]
   [-VoiceReceiver <IVoiceReceiver[]>]
   [-WebhookReceiver <IWebhookReceiver[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建新的操作组或更新现有操作组。

示例

示例 1:创建操作组

$email1 = New-AzActionGroupEmailReceiverObject -EmailAddress user@example.com -Name user1
$sms1 = New-AzActionGroupSmsReceiverObject -CountryCode '{countrycode}' -Name user2 -PhoneNumber '{phonenumber}'
New-AzActionGroup -Name 'actiongroup1' -ResourceGroupName 'Monitor-Action' -Location northcentralus -GroupShortName ag1 -EmailReceiver $email1 -SmsReceiver $sms1

ArmRoleReceiver           : {}
AutomationRunbookReceiver : {}
AzureAppPushReceiver      : {}
AzureFunctionReceiver     : {}
EmailReceiver             : {{
                              "name": "user1",
                              "emailAddress": "user@example.com",
                              "useCommonAlertSchema": false,
                              "status": "Enabled"
                            }}
Enabled                   : False
EventHubReceiver          : {}
GroupShortName            : ag1
Id                        : /subscriptions/{subid}/resourceGroups/Monitor-Action/providers/microsoft.insights/actionGroups/actiongroup1
ItsmReceiver              : {}
Location                  : northcentralus
LogicAppReceiver          : {}
Name                      : actiongroup1
ResourceGroupName         : Monitor-Action
SmsReceiver               : {{
                              "name": "user2",
                              "countryCode": "{countrycode}",
                              "phoneNumber": "{phonenumber}",
                              "status": "Enabled"
                            }}
Tag                       : {
                            }
Type                      : Microsoft.Insights/ActionGroups
VoiceReceiver             : {}
WebhookReceiver           : {}

前两个命令创建两个接收器。 最后一个命令创建一个操作组,包括两个接收方。

示例 2:创建另一个操作组

New-AzActionGroup -Name 'actiongroup1' -ResourceGroupName 'Monitor-Action' -Location northcentralus -GroupShortName ag1

ArmRoleReceiver           : {}
AutomationRunbookReceiver : {}
AzureAppPushReceiver      : {}
AzureFunctionReceiver     : {}
EmailReceiver             : {}
Enabled                   : False
EventHubReceiver          : {}
GroupShortName            : ag1
Id                        : /subscriptions/{subid}/resourceGroups/Monitor-Action/providers/microsoft.insights/actionGroups/actiongroup1
ItsmReceiver              : {}
Location                  : northcentralus
LogicAppReceiver          : {}
Name                      : actiongroup1
ResourceGroupName         : Monitor-Action
SmsReceiver               : {}
Tag                       : {
                            }
Type                      : Microsoft.Insights/ActionGroups
VoiceReceiver             : {}
WebhookReceiver           : {}

此命令创建一个没有接收方的操作组。

参数

-ArmRoleReceiver

属于此操作组的 ARM 角色接收器列表。 角色是 Azure RBAC 角色,仅支持内置角色。 若要构造,请参阅 ARMROLERECEIVER 属性的 NOTES 部分并创建哈希表。

Type:IArmRoleReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AutomationRunbookReceiver

属于此操作组的 AutomationRunbook 接收器的列表。 若要构造,请参阅 AUTOMATIONRUNBOOKRECEIVER 属性的 NOTES 部分,并创建哈希表。

Type:IAutomationRunbookReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureAppPushReceiver

属于此操作组的 AzureAppPush 接收器列表。 若要构造,请参阅 AZUREAPPPUSHRECEIVER 属性的 NOTES 部分,并创建哈希表。

Type:IAzureAppPushReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureFunctionReceiver

属于此操作组的 Azure 函数接收器的列表。 若要构造,请参阅 AZUREFUNCTIONRECEIVER 属性的 NOTES 部分并创建哈希表。

Type:IAzureFunctionReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EmailReceiver

属于此操作组的电子邮件接收方列表。 若要构造,请参阅 EMAILRECEIVER 属性的 NOTES 部分,并创建哈希表。

Type:IEmailReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

指示是否启用此操作组。 如果未启用操作组,则其接收方不会接收通信。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventHubReceiver

属于此操作组的事件中心接收器的列表。 若要构造,请参阅 EVENTHUBRECEIVER 属性的 NOTES 部分并创建哈希表。

Type:IEventHubReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupShortName

操作组的短名称。 这将在短信中使用。

Type:String
Aliases:ShortName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

要构造的标识参数,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

Type:IActionGroupIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ItsmReceiver

属于此操作组的 ITSM 接收器的列表。 若要构造,请参阅 ITSMRECEIVER 属性的 NOTES 部分并创建哈希表。

Type:IItsmReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JsonFilePath

提供给“创建”操作的 Json 文件的路径

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JsonString

提供给“创建”操作的 Json 字符串

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

资源位置

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LogicAppReceiver

属于此操作组的逻辑应用接收器列表。 若要构造,请参阅 LOGICAPPRECEIVER 属性的 NOTES 部分并创建哈希表。

Type:ILogicAppReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

操作组的名称。

Type:String
Aliases:ActionGroupName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SmsReceiver

属于此操作组的 SMS 接收器列表。 若要构造,请参阅 SMSRECEIVER 属性的 NOTES 部分并创建哈希表。

Type:ISmsReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

目标订阅的 ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

资源标记

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VoiceReceiver

属于此操作组的语音接收器列表。 若要构造,请参阅 VOICERECEIVER 属性的 NOTES 部分并创建哈希表。

Type:IVoiceReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WebhookReceiver

属于此操作组的 Webhook 接收器列表。 若要构造,请参阅 WEBHOOKRECEIVER 属性的 NOTES 部分,并创建哈希表。

Type:IWebhookReceiver[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

IActionGroupIdentity

输出

IActionGroupResource