Set-AzActivityLogAlert

Modul:

Az.Monitor Module

Vytvoří novou nebo nastaví existující upozornění protokolu aktivit.

Syntaxe

SetByNameAndResourceGroup

Set-AzActivityLogAlert
    -Location <String>
    -Name <String>
    -ResourceGroupName <String>
    -Scope <System.Collections.Generic.List`1[System.String]>
    -Condition <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]>
    -Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]>
    [-DisableAlert]
    [-Description <String>]
    [-Tag <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceId

Set-AzActivityLogAlert
    -ResourceId <String>
    [-Location <String>]
    [-Scope <System.Collections.Generic.List`1[System.String]>]
    [-Condition <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]>]
    [-Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]>]
    [-DisableAlert]
    [-Description <String>]
    [-Tag <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByInputObject

Set-AzActivityLogAlert
    -InputObject <PSActivityLogAlertResource>
    [-Scope <System.Collections.Generic.List`1[System.String]>]
    [-Condition <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]>]
    [-Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]>]
    [-Description <String>]
    [-Tag <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Set-AzActivityLogAlert vytvoří novou nebo nastaví existující upozornění protokolu aktivit. Pro značky, podmínky a akce musí být objekty vytvořeny předem a předány jako parametry v tomto volání jako čárka oddělené (viz příklad níže). Tato rutina implementuje model ShouldProcess, tj. může před vytvořením nebo úpravou prostředku požádat uživatele o potvrzení. POZNÁMKA: Tato rutina a související rutiny nahrazují zastaralé rutiny (listopad 2017) Add-AzLogAlertRule.

Příklady

Příklad 1: Vytvoření upozornění protokolu aktivit

PS C:\>$location = 'Global'
PS C:\>$alertName = 'myAlert'
PS C:\>$resourceGroupName = 'theResourceGroupName'
PS C:\>$condition1 = New-AzActivityLogAlertCondition -Field 'field1' -Equal 'equals1'
PS C:\>$condition2 = New-AzActivityLogAlertCondition -Field 'field2' -Equal 'equals2'
PS C:\>$dict = New-Object "System.Collections.Generic.Dictionary``2[System.String,System.String]"
PS C:\>$dict.Add('key1', 'value1')
PS C:\>$actionGrp1 = New-AzActionGroup -ActionGroupId 'actiongr1' -WebhookProperty $dict
PS C:\>Set-AzActivityLogAlert -Location $location -Name $alertName -ResourceGroupName $resourceGroupName -Scope 'scope1','scope2' -Action $actionGrp1 -Condition $condition1, $condition2

První čtyři příkazy vytvoří podmínku typu list a skupinu akcí. Poslední příkaz vytvoří upozornění protokolu aktivit pomocí podmínky a skupiny akcí.

Příklad 2: Vytvoření upozornění protokolu aktivit je zakázané

PS C:\>$location = 'Global'
PS C:\>$alertName = 'myAlert'
PS C:\>$resourceGroupName = 'theResourceGroupName'
PS C:\>$condition1 = New-AzActivityLogAlertCondition -Field 'field1' -Equal 'equals1'
PS C:\>$condition2 = New-AzActivityLogAlertCondition -Field 'field2' -Equal 'equals2'
PS C:\>$dict = New-Object "System.Collections.Generic.Dictionary``2[System.String,System.String]"
PS C:\>$dict.Add('key1', 'value1')
PS C:\>$actionGrp1 = New-AzActionGroup -ActionGroupId 'actiongr1' -WebhookProperty $dict
PS C:\>Set-AzActivityLogAlert -Location $location -Name $alertName -ResourceGroupName $resourceGroupName -Scope 'scope1','scope2' -Action $actionGrp1 -Condition $condition1, $condition2 -DisableAlert

První čtyři příkazy vytvoří podmínku typu list a skupinu akcí. Poslední příkaz vytvoří upozornění protokolu aktivit pomocí podmínky a skupiny akcí, ale vytvoří výstrahu zakázanou.

Příklad 3: Nastavení upozornění protokolu aktivit na základě hodnoty z kanálu nebo parametru InputObject

PS C:\>Get-AzActivityLogAlert -Name $alertName -ResourceGroupName $resourceGroupName | Set-AzActivityLogAlert
PS C:\>$alert = Get-AzActivityLogAlert -Name $alertName -ResourceGroupName $resourceGroupName
PS C:\>$alert.Description = 'Changing the description'
PS C:\>$alert.Enabled = $false
PS C:\>Set-AzActivityLogAlert -InputObject $alert

První příkaz je podobný nop, nastaví výstrahu se stejnými hodnotami, které už obsahovala Zbývající příkazy načítají pravidlo upozornění, změňte popis a zakažte ho a pak pomocí parametru InputObject tyto změny zachovají.

Příklad 4: Nastavení upozornění protokolu aktivit na základě hodnoty ResourceId z kanálu

PS C:\>Get-AzResource -ResourceGroupName "myResourceGroup" -Name "myLogAlert" | Set-AzActivityLogAlert -DisableAlert

Pokud dané pravidlo upozornění protokolu existuje, tento příkaz ho zakáže.

Parametry

-Action

Seznam skupin akcí pro upozornění protokolu aktivit

Vlastnosti parametru

Typ:	List<T>[ActivityLogAlertActionGroup]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Condition

Seznam podmínek pro upozornění protokolu aktivit POZNÁMKA: V seznamu podmínek musí být alespoň jedna s polem rovnajícím se "Category". Back-end odpoví 400 (BadRequest), pokud tato podmínka neexistuje.

Vlastnosti parametru

Typ:	List<T>[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Description

Popis prostředku upozornění.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DisableAlert

Umožňuje uživateli vytvořit zakázané upozornění protokolu aktivit. Pokud není tato možnost uvedena, jsou upozornění povolena.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Nastaví vlastnost tags InputObject volání tak, aby extrahovala požadovaný název a vlastnosti názvu skupiny prostředků.

Vlastnosti parametru

Typ:	PSActivityLogAlertResource
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByInputObject

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Location

Umístění, kde bude existovat upozornění protokolu aktivit.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

Název upozornění protokolu aktivit.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

Název skupiny prostředků, ve které prostředek upozornění bude existovat.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceId

Nastaví vlastnost ResourceId tags volání tak, aby extrahovala požadovaný název, vlastnosti názvu skupiny prostředků.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Scope

Seznam oborů pro upozornění protokolu aktivit.

Vlastnosti parametru

Typ:	List<T>[String]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Tag

Nastaví vlastnost značek prostředku upozornění protokolu aktivit.

Vlastnosti parametru

Typ:	Dictionary<TKey,TValue>[System.String,System.String]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByNameAndResourceGroup

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

List<T>

List<T>

List<T>

Dictionary<TKey,TValue>

PSActivityLogAlertResource

Výstupy

PSActivityLogAlertResource

Související odkazy

• Enable-AzActivityLogAlert
• Disable-AzActivityLogAlert
• Get-AzActivityLogAlert
• Remove-AzActivityLogAlert
• New-AzActionGroup
• New-AzActivityLogAlertCondition