New-AzDiagnosticSetting

Skapar eller uppdaterar diagnostikinställningar för den angivna resursen.

Syntax

New-AzDiagnosticSetting
   -Name <String>
   -ResourceId <String>
   [-EventHubAuthorizationRuleId <String>]
   [-EventHubName <String>]
   [-Log <ILogSettings[]>]
   [-LogAnalyticsDestinationType <String>]
   [-MarketplacePartnerId <String>]
   [-Metric <IMetricSettings[]>]
   [-ServiceBusRuleId <String>]
   [-StorageAccountId <String>]
   [-WorkspaceId <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Skapar eller uppdaterar diagnostikinställningar för den angivna resursen.

Exempel

Exempel 1: Skapa diagnostikinställning

$subscriptionId = (Get-AzContext).Subscription.Id
$metric = @()
$log = @()
$metric += New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics -RetentionPolicyDay 7 -RetentionPolicyEnabled $true
$log += New-AzDiagnosticSettingLogSettingsObject -Enabled $true -Category ContainerEventLogs -RetentionPolicyDay 7 -RetentionPolicyEnabled $true
New-AzDiagnosticSetting -Name test-setting -ResourceId /subscriptions/$subscriptionId/resourceGroups/test-rg-name/providers/Microsoft.AppPlatform/Spring/springcloud-001 -WorkspaceId /subscriptions/$subscriptionId/resourcegroups/test-rg-name/providers/microsoft.operationalinsights/workspaces/test-workspace -Log $log -Metric $metric

Skapa diagnostikinställning för resurs med log analytics-arbetsyta som mål

Exempel 2: Skapa diagnostikinställning för alla kategorier som stöds

$subscriptionId = (Get-AzContext).Subscription.Id
$metric = @()
$log = @()
$categories = Get-AzDiagnosticSettingCategory -ResourceId /subscriptions/$subscriptionId/resourceGroups/test-rg-name/providers/Microsoft.AppPlatform/Spring/springcloud-001
$categories | ForEach-Object {if($_.CategoryType -eq "Metrics"){$metric+=New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category $_.Name -RetentionPolicyDay 7 -RetentionPolicyEnabled $true} else{$log+=New-AzDiagnosticSettingLogSettingsObject -Enabled $true -Category $_.Name -RetentionPolicyDay 7 -RetentionPolicyEnabled $true}}
New-AzDiagnosticSetting -Name test-setting -ResourceId /subscriptions/$subscriptionId/resourceGroups/test-rg-name/providers/Microsoft.AppPlatform/Spring/springcloud-001 -WorkspaceId /subscriptions/$subscriptionId/resourcegroups/test-rg-name/providers/microsoft.operationalinsights/workspaces/test-workspace -Log $log -Metric $metric

Skapa diagnostikinställning för alla kategorier som stöds

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventHubAuthorizationRuleId

Resurs-ID:t för händelsehubbens auktoriseringsregel.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventHubName

Namnet på händelsehubben. Om inget anges väljs standardhändelsehubben.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Log

Listan över logginställningar. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för LOG-egenskaper och skapa en hash-tabell.

Type:ILogSettings[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogAnalyticsDestinationType

En sträng som anger om exporten till Log Analytics ska använda standardmåltypen, d.v.s. AzureDiagnostics, eller använda en måltyp som konstruerats på följande sätt: <normaliserat namn på tjänstidentitet>_<normaliserad kategori>. Möjliga värden är: Dedikerad och null (null är standard.)

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MarketplacePartnerId

Det fullständiga ARM-resurs-ID:t för Marketplace-resursen som du vill skicka diagnostikloggar till.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Metric

Listan över måttinställningar. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för METRIC-egenskaper och skapa en hash-tabell.

Type:IMetricSettings[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Namnet på diagnostikinställningen.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Resursens identifierare.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceBusRuleId

Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountId

Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceId

Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Utdata

IDiagnosticSettingsResource