Set-AzActivityLogAlert
Hiermee maakt u een nieuwe waarschuwing of stelt u een bestaande waarschuwing voor activiteitenlogboeken in.
Syntaxis
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>]
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
Met de cmdlet Set-AzActivityLogAlert maakt u een nieuwe of stelt u een bestaande waarschuwing voor activiteitenlogboeken in.
Voor tags, voorwaarden en acties moeten de objecten vooraf worden gemaakt en als parameters in deze aanroep worden doorgegeven als door komma's gescheiden (zie het onderstaande voorbeeld).
Met deze cmdlet wordt het ShouldProcess-patroon geïmplementeerd. Het kan bijvoorbeeld een bevestiging van de gebruiker aanvragen voordat de resource daadwerkelijk wordt gemaakt/gewijzigd.
OPMERKING : Deze cmdlet en de bijbehorende cmdlets vervangen de afgeschafte (november 2017) Add-AzLogAlertRule .
Voorbeelden
Voorbeeld 1: Een waarschuwing voor activiteitenlogboek maken
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
Met de eerste vier opdrachten maakt u bladvoorwaarde en actiegroep.
Met de laatste opdracht maakt u een waarschuwing voor activiteitenlogboek met behulp van de voorwaarde en de actiegroep.
Voorbeeld 2: Een waarschuwing voor activiteitenlogboeken maken uitgeschakeld
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
Met de eerste vier opdrachten maakt u bladvoorwaarde en actiegroep.
Met de laatste opdracht maakt u een waarschuwing voor activiteitenlogboek met behulp van de voorwaarde en de actiegroep, maar wordt de waarschuwing uitgeschakeld.
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
De eerste opdracht is vergelijkbaar met een nop, het stelt de waarschuwing in met dezelfde waarden als die al de rest van de opdrachten bevat de waarschuwingsregel ophalen, de beschrijving wijzigen en uitschakelen, en vervolgens de parameter InputObject gebruiken om deze wijzigingen te behouden
Voorbeeld 4: Een waarschuwing voor activiteitenlogboeken instellen op basis van de ResourceId-waarde uit de pijp
PS C:\>Get-AzResource -ResourceGroupName "myResourceGroup" -Name "myLogAlert" | Set-AzActivityLogAlert -DisableAlert
Als de opgegeven waarschuwingsregel voor logboeken bestaat, wordt deze door deze opdracht uitgeschakeld.
Parameters
-Action
De lijst met actiegroepen voor de waarschuwing voor het activiteitenlogboek.
Parametereigenschappen
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-Condition
De lijst met voorwaarden voor de waarschuwing voor het activiteitenlogboek.
OPMERKING : In de lijst met voorwaarden moet er ten minste één zijn met het veld gelijk aan 'Categorie'. De back-end reageert met 400 (BadRequest) als deze voorwaarde niet aanwezig is.
Parametereigenschappen
Type: List<T> [ Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition ]
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False Aliassen: Cf
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Parametereigenschappen
Type: IAzureContextContainer
Default value: None Ondersteunt jokertekens: False DontShow: False Aliassen: AzContext, AzureRmContext, AzureCredential
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Description
De beschrijving van de waarschuwingsresource.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
SetByResourceId
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-DisableAlert
Hiermee kan de gebruiker een uitgeschakelde waarschuwing voor het activiteitenlogboek maken. Als dit niet is opgegeven, worden de waarschuwingen ingeschakeld.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SetByResourceId
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
Hiermee stelt u de eigenschap InputObject-tags van de aanroep in om de vereiste naam en de eigenschappen van de resourcegroep te extraheren.
SetByInputObject
Position: Named Verplicht: True Waarde uit pijplijn: True Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Location
De locatie waar de waarschuwing voor het activiteitenlogboek bestaat.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-Name
De naam van de waarschuwing voor het activiteitenlogboek.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-ResourceGroupName
De naam van de resourcegroep waar de waarschuwingsresource gaat bestaan.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-ResourceId
Hiermee stelt u de eigenschap ResourceId-tags van de aanroep in om de vereiste naam, de eigenschappen van de resourcegroepnaam, te extraheren.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByResourceId
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-Scope
De lijst met bereiken voor de waarschuwing voor het activiteitenlogboek.
Parametereigenschappen
Type: List<T> [ String ]
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-Tag
Hiermee stelt u de eigenschap tags van de waarschuwingsresource voor het activiteitenlogboek in.
Parametereigenschappen
Type: Dictionary<TKey,TValue> [ System.String,System.String ]
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SetByNameAndResourceGroup
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
SetByResourceId
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False Aliassen: Wi
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParameters voor meer informatie.
Uitvoerwaarden