Partilhar via

New-AzActionGroup

Módulo:
Az.Monitor Module

Crie um novo grupo de ações ou crie um existente.

Sintaxe

CreateExpanded (Predefinição) 

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

Description

Crie um novo grupo de ações ou crie um existente.

Exemplos

Exemplo 1: Criar um grupo de ações

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

Os dois primeiros comandos criam dois recetores. O comando final cria um grupo de ação incluindo os dois recetores.

Exemplo 2: criar outro grupo de ações

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

Este comando cria um grupo de ação sem recetor.

Parâmetros

-ArmRoleReceiver

A lista de recetores de função ARM que fazem parte deste grupo de ação. As funções são funções RBAC do Azure e apenas as funções internas são suportadas.

Propriedades dos parâmetros

Tipo:

IArmRoleReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AutomationRunbookReceiver

A lista de recetores AutomationRunbook que fazem parte desse grupo de ações.

Propriedades dos parâmetros

Tipo:

IAutomationRunbookReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AzureAppPushReceiver

A lista de recetores AzureAppPush que fazem parte deste grupo de ações.

Propriedades dos parâmetros

Tipo:

IAzureAppPushReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AzureFunctionReceiver

A lista de recetores de função azure que fazem parte deste grupo de ações.

Propriedades dos parâmetros

Tipo:

IAzureFunctionReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades dos parâmetros

Tipo:PSObject
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzureRMContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EmailReceiver

A lista de destinatários de e-mail que fazem parte deste grupo de ações.

Propriedades dos parâmetros

Tipo:

IEmailReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Enabled

Indica se esse grupo de ações está habilitado. Se um grupo de ação não estiver habilitado, nenhum de seus recetores receberá comunicações.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EventHubReceiver

A lista de recetores de hub de eventos que fazem parte desse grupo de ações.

Propriedades dos parâmetros

Tipo:

IEventHubReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-GroupShortName

O nome abreviado do grupo de ação. Isso será usado em mensagens SMS.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome curto

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

Parâmetro de identidade

Propriedades dos parâmetros

Tipo:IActionGroupIdentity
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateViaIdentityExpanded
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ItsmReceiver

A lista de recetores ITSM que fazem parte deste grupo de ação.

Propriedades dos parâmetros

Tipo:

IItsmReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateViaJsonFilePath
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JsonString

Cadeia de caracteres Json fornecida para a operação Create

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateViaJsonString
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Location

Localização do recurso

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-LogicAppReceiver

A lista de recetores de aplicativos lógicos que fazem parte desse grupo de ações.

Propriedades dos parâmetros

Tipo:

ILogicAppReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

O nome do grupo de ações.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ActionGroupName

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaJsonString
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaJsonFilePath
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaJsonString
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaJsonFilePath
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SmsReceiver

A lista de recetores de SMS que fazem parte deste grupo de ação.

Propriedades dos parâmetros

Tipo:

ISmsReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SubscriptionId

A ID da assinatura de destino.

Propriedades dos parâmetros

Tipo:String
Default value:(Get-AzContext).Subscription.Id
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaJsonString
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaJsonFilePath
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Tag

Etiquetas de recursos

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VoiceReceiver

A lista de recetores de voz que fazem parte deste grupo de ação.

Propriedades dos parâmetros

Tipo:

IVoiceReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WebhookReceiver

A lista de recetores webhook que fazem parte deste grupo de ação.

Propriedades dos parâmetros

Tipo:

IWebhookReceiver[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

IActionGroupIdentity

Saídas

IActionGroupResource