Delen via

New-AzActionGroup

  • Referentie
Module:
Az.Monitor

Maak een nieuwe actiegroep of maak een bestaande actiegroep.

Syntaxis

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>]

Description

Maak een nieuwe actiegroep of maak een bestaande actiegroep.

Voorbeelden

Voorbeeld 1: Een actiegroep maken

$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           : {}

De eerste twee opdrachten maken twee ontvangers. Met de laatste opdracht maakt u een actiegroep met inbegrip van de twee ontvangers.

Voorbeeld 2: een andere actiegroep maken

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           : {}

Met deze opdracht maakt u een actiegroep zonder ontvanger.

Parameters

-ArmRoleReceiver

De lijst met ARM-rolontvangers die deel uitmaken van deze actiegroep. Rollen zijn Azure RBAC-rollen en alleen ingebouwde rollen worden ondersteund.

Type:IArmRoleReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AutomationRunbookReceiver

De lijst met AutomationRunbook-ontvangers die deel uitmaken van deze actiegroep.

Type:IAutomationRunbookReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AzureAppPushReceiver

De lijst met AzureAppPush-ontvangers die deel uitmaken van deze actiegroep.

Type:IAzureAppPushReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AzureFunctionReceiver

De lijst met ontvangers van Azure-functies die deel uitmaken van deze actiegroep.

Type:IAzureFunctionReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EmailReceiver

De lijst met e-mailontvangers die deel uitmaken van deze actiegroep.

Type:IEmailReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

Geeft aan of deze actiegroep is ingeschakeld. Als een actiegroep niet is ingeschakeld, ontvangen geen van de ontvangers communicatie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EventHubReceiver

De lijst met Event Hub-ontvangers die deel uitmaken van deze actiegroep.

Type:IEventHubReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GroupShortName

De korte naam van de actiegroep. Dit wordt gebruikt in sms-berichten.

Type:String
Aliassen:ShortName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Identiteitsparameter

Type:IActionGroupIdentity
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ItsmReceiver

De lijst met ITSM-ontvangers die deel uitmaken van deze actiegroep.

Type:IItsmReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JsonFilePath

Pad van het Json-bestand dat is opgegeven bij de bewerking Maken

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JsonString

Json-tekenreeks die is opgegeven bij de bewerking Maken

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Resourcelocatie

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LogicAppReceiver

De lijst met ontvangers van logische apps die deel uitmaken van deze actiegroep.

Type:ILogicAppReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

De naam van de actiegroep.

Type:String
Aliassen:ActionGroupName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SmsReceiver

De lijst met sms-ontvangers die deel uitmaken van deze actiegroep.

Type:ISmsReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubscriptionId

De id van het doelabonnement.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Resourcetags

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VoiceReceiver

De lijst met spraakontvangers die deel uitmaken van deze actiegroep.

Type:IVoiceReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WebhookReceiver

De lijst met webhookontvangers die deel uitmaken van deze actiegroep.

Type:IWebhookReceiver[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

IActionGroupIdentity

Uitvoerwaarden

IActionGroupResource