Поделиться через

New-AzActionGroup

Модуль:
Az.Monitor Module

создайте новую группу действий или создайте существующую.

Синтаксис

CreateExpanded (по умолчанию) 

New-AzActionGroup
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    [-SubscriptionId <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>]

CreateViaJsonString 

New-AzActionGroup
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath 

New-AzActionGroup
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpanded 

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 [email protected] -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": "[email protected]",
                              "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, входящих в эту группу действий. Роли — это роли RBAC Azure, а поддерживаются только встроенные роли.

Свойства параметра

Тип:

IArmRoleReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AutomationRunbookReceiver

Список приемников AutomationRunbook, входящих в эту группу действий.

Свойства параметра

Тип:

IAutomationRunbookReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AzureAppPushReceiver

Список получателей AzureAppPush, входящих в эту группу действий.

Свойства параметра

Тип:

IAzureAppPushReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AzureFunctionReceiver

Список приемников функций Azure, входящих в эту группу действий.

Свойства параметра

Тип:

IAzureFunctionReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Параметр DefaultProfile не работает. Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.

Свойства параметра

Тип:PSObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EmailReceiver

Список получателей электронной почты, входящих в эту группу действий.

Свойства параметра

Тип:

IEmailReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Enabled

Указывает, включена ли эта группа действий. Если группа действий не включена, ни один из получателей не получит сообщения.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EventHubReceiver

Список приемников концентратора событий, входящих в эту группу действий.

Свойства параметра

Тип:

IEventHubReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GroupShortName

Короткое имя группы действий. Это будет использоваться в SMS-сообщениях.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ShortName

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InputObject

Параметр удостоверения

Свойства параметра

Тип:IActionGroupIdentity
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateViaIdentityExpanded
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ItsmReceiver

Список получателей ITSM, входящих в эту группу действий.

Свойства параметра

Тип:

IItsmReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JsonFilePath

Путь к json-файлу, предоставленному операции создания

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateViaJsonFilePath
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JsonString

Строка JSON, предоставленная операции create

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateViaJsonString
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Location

Расположение ресурса

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LogicAppReceiver

Список получателей приложений логики, входящих в эту группу действий.

Свойства параметра

Тип:

ILogicAppReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Имя группы действий.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ActionGroupName

Наборы параметров

CreateExpanded
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaJsonString
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaJsonFilePath
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceGroupName

Имя группы ресурсов. Имя не зависит от регистра.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaJsonString
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaJsonFilePath
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SmsReceiver

Список получателей SMS, входящих в эту группу действий.

Свойства параметра

Тип:

ISmsReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SubscriptionId

Идентификатор целевой подписки.

Свойства параметра

Тип:String
Default value:(Get-AzContext).Subscription.Id
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaJsonString
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaJsonFilePath
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Tag

Теги ресурсов

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VoiceReceiver

Список голосовых приемников, входящих в эту группу действий.

Свойства параметра

Тип:

IVoiceReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WebhookReceiver

Список получателей веб-перехватчиков, входящих в эту группу действий.

Свойства параметра

Тип:

IWebhookReceiver[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateViaIdentityExpanded
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

IActionGroupIdentity

Выходные данные

IActionGroupResource