Update-AzDataCollectionRule

Riferimento

Modulo:: Az.Monitor

Aggiornare una regola di raccolta dati.

Sintassi

Update-AzDataCollectionRule
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-DataCollectionEndpointId <String>]
      [-DataFlow <IDataFlow[]>]
      [-DataSourceDataImportEventHubConsumerGroup <String>]
      [-DataSourceDataImportEventHubName <String>]
      [-DataSourceDataImportEventHubStream <String>]
      [-DataSourceExtension <IExtensionDataSource[]>]
      [-DataSourceIisLog <IIisLogsDataSource[]>]
      [-DataSourceLogFile <ILogFilesDataSource[]>]
      [-DataSourcePerformanceCounter <IPerfCounterDataSource[]>]
      [-DataSourcePlatformTelemetry <IPlatformTelemetryDataSource[]>]
      [-DataSourcePrometheusForwarder <IPrometheusForwarderDataSource[]>]
      [-DataSourceSyslog <ISyslogDataSource[]>]
      [-DataSourceWindowsEventLog <IWindowsEventLogDataSource[]>]
      [-DataSourceWindowsFirewallLog <IWindowsFirewallLogsDataSource[]>]
      [-Description <String>]
      [-DestinationAzureMonitorMetricName <String>]
      [-DestinationEventHub <IEventHubDestination[]>]
      [-DestinationEventHubsDirect <IEventHubDirectDestination[]>]
      [-DestinationLogAnalytic <ILogAnalyticsDestination[]>]
      [-DestinationMonitoringAccount <IMonitoringAccountDestination[]>]
      [-DestinationStorageAccount <IStorageBlobDestination[]>]
      [-DestinationStorageBlobsDirect <IStorageBlobDestination[]>]
      [-DestinationStorageTablesDirect <IStorageTableDestination[]>]
      [-IdentityType <String>]
      [-Kind <String>]
      [-Location <String>]
      [-StreamDeclaration <Hashtable>]
      [-Tag <Hashtable>]
      [-UserAssignedIdentity <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzDataCollectionRule
      -InputObject <IDataCollectionRuleIdentity>
      [-DataCollectionEndpointId <String>]
      [-DataFlow <IDataFlow[]>]
      [-DataSourceDataImportEventHubConsumerGroup <String>]
      [-DataSourceDataImportEventHubName <String>]
      [-DataSourceDataImportEventHubStream <String>]
      [-DataSourceExtension <IExtensionDataSource[]>]
      [-DataSourceIisLog <IIisLogsDataSource[]>]
      [-DataSourceLogFile <ILogFilesDataSource[]>]
      [-DataSourcePerformanceCounter <IPerfCounterDataSource[]>]
      [-DataSourcePlatformTelemetry <IPlatformTelemetryDataSource[]>]
      [-DataSourcePrometheusForwarder <IPrometheusForwarderDataSource[]>]
      [-DataSourceSyslog <ISyslogDataSource[]>]
      [-DataSourceWindowsEventLog <IWindowsEventLogDataSource[]>]
      [-DataSourceWindowsFirewallLog <IWindowsFirewallLogsDataSource[]>]
      [-Description <String>]
      [-DestinationAzureMonitorMetricName <String>]
      [-DestinationEventHub <IEventHubDestination[]>]
      [-DestinationEventHubsDirect <IEventHubDirectDestination[]>]
      [-DestinationLogAnalytic <ILogAnalyticsDestination[]>]
      [-DestinationMonitoringAccount <IMonitoringAccountDestination[]>]
      [-DestinationStorageAccount <IStorageBlobDestination[]>]
      [-DestinationStorageBlobsDirect <IStorageBlobDestination[]>]
      [-DestinationStorageTablesDirect <IStorageTableDestination[]>]
      [-IdentityType <String>]
      [-Kind <String>]
      [-Location <String>]
      [-StreamDeclaration <Hashtable>]
      [-Tag <Hashtable>]
      [-UserAssignedIdentity <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Aggiornare una regola di raccolta dati.

Esempio

Esempio 1: Aggiornare il tag per la regola di raccolta dati

$syslog = New-AzSyslogDataSourceObject -FacilityName syslog -LogLevel Alert,Critical,Emergency -Name syslogBase -Stream Microsoft-Syslog
Update-AzDataCollectionRule -Name myCollectionRule1 -ResourceGroupName Monitor-ActionGroup -DataSourceSyslog $syslog

DataCollectionEndpointId                  : 
DataFlow                                  : {{
                                              "streams": [ "Microsoft-InsightsMetrics" ],
                                              "destinations": [ "azureMonitorMetrics-default" ]
                                            }}
DataSourceDataImportEventHubConsumerGroup : 
DataSourceDataImportEventHubName          : 
DataSourceDataImportEventHubStream        : 
DataSourceExtension                       : 
DataSourceIisLog                          : 
DataSourceLogFile                         : 
DataSourcePerformanceCounter              : {{
                                              "streams": [ "Microsoft-Perf" ],
                                              "samplingFrequencyInSeconds": 15,
                                              "counterSpecifiers": [ "\\\\Processor(_Total)\\\\% Processor Time", "\\\\Memory\\\\Committed Bytes",
                                            "\\\\LogicalDisk(_Total)\\\\Free Megabytes", "\\\\PhysicalDisk(_Total)\\\\Avg. Disk Queue Length" ],
                                              "name": "cloudTeamCoreCounters"
                                            }, {
                                              "streams": [ "Microsoft-Perf" ],
                                              "samplingFrequencyInSeconds": 30,
                                              "counterSpecifiers": [ "\\\\Process(_Total)\\\\Thread Count" ],
                                              "name": "appTeamExtraCounters"
                                            }}
DataSourcePlatformTelemetry               : 
DataSourcePrometheusForwarder             : 
DataSourceSyslog                          : {{
                                              "streams": [ "Microsoft-Syslog" ],
                                              "facilityNames": [ "syslog" ],
                                              "logLevels": [ "Alert", "Critical", "Emergency" ],
                                              "name": "syslogBase"
                                            }}
DataSourceWindowsEventLog                 : {{
                                              "streams": [ "Microsoft-WindowsEvent" ],
                                              "xPathQueries": [ "System![System[(Level = 1 or Level = 2 or Level = 3)]]", "Application!*[System[(Level = 1 or Level = 2   
                                            or Level = 3)]]" ],
                                              "name": "appTeam1AppEvents"
                                            }}
DataSourceWindowsFirewallLog              : 
Description                               : 
DestinationAzureMonitorMetricName         : azureMonitorMetrics-default
DestinationEventHub                       : 
DestinationEventHubsDirect                : 
DestinationLogAnalytic                    : 
DestinationMonitoringAccount              : 
DestinationStorageAccount                 : 
DestinationStorageBlobsDirect             : 
DestinationStorageTablesDirect            : 
Etag                                      : "9200a3d3-0000-0100-0000-654c72ae0000"
Id                                        : /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourceGroups/Monitor-ActionGroup/providers/Microsoft.Insights/dataColle 
                                            ctionRules/myCollectionRule1
IdentityPrincipalId                       : 
IdentityTenantId                          : 
IdentityType                              : 
IdentityUserAssignedIdentity              : {
                                            }
ImmutableId                               : dcr-e30a8188813f426d962ef7053a3d1be4
Kind                                      : 
Location                                  : eastus
MetadataProvisionedBy                     : 
MetadataProvisionedByResourceId           : 
Name                                      : myCollectionRule1
ProvisioningState                         : Succeeded
ResourceGroupName                         : Monitor-ActionGroup
StreamDeclaration                         : {
                                            }
SystemDataCreatedAt                       : 11/9/2023 5:04:01 AM
SystemDataCreatedBy                       : v-jiaji@microsoft.com
SystemDataCreatedByType                   : User
SystemDataLastModifiedAt                  : 11/9/2023 5:48:29 AM
SystemDataLastModifiedBy                  : v-jiaji@microsoft.com
SystemDataLastModifiedByType              : User
Tag                                       : {
                                            }
Type                                      : Microsoft.Insights/dataCollectionRules

Questo comando aggiorna la regola di raccolta dati.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DataCollectionEndpointId

ID risorsa dell'endpoint di raccolta dati con cui è possibile usare questa regola.

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

-DataFlow

Specifica dei flussi di dati. Per costruire, vedere la sezione NOTES per le proprietà DATAFLOW e creare una tabella hash.

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

-DataSourceDataImportEventHubConsumerGroup

Nome del gruppo di consumer dell'hub eventi

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

-DataSourceDataImportEventHubName

Nome descrittivo per l'origine dati. Questo nome deve essere univoco in tutte le origini dati (indipendentemente dal tipo) all'interno della regola di raccolta dati.

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

-DataSourceDataImportEventHubStream

Flusso da raccogliere da EventHub

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

-DataSourceExtension

Elenco delle configurazioni dell'origine dati dell'estensione macchina virtuale di Azure. Per costruire, vedere la sezione NOTES per le proprietà DATASOURC edizione Enterprise XTENSION e creare una tabella hash.

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

-DataSourceIisLog

Elenco delle configurazioni di origine dei log IIS. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCEIISLOG e creare una tabella hash.

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

-DataSourceLogFile

Elenco delle configurazioni di origine dei file di log. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCELOGFILE e creare una tabella hash.

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

-DataSourcePerformanceCounter

Elenco delle configurazioni dell'origine dati del contatore delle prestazioni. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCEPERFORMANCECOUNTER e creare una tabella hash.

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

-DataSourcePlatformTelemetry

L'elenco delle configurazioni di telemetria della piattaforma Da costruire, vedere la sezione NOTES per le proprietà DATASOURCEPLATFORMTELEMETRY e creare una tabella hash.

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

-DataSourcePrometheusForwarder

Elenco delle configurazioni dell'origine dati del server d'inoltro Prometheus. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCEPROMETHEUSFORWARDER e creare una tabella hash.

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

-DataSourceSyslog

Elenco delle configurazioni dell'origine dati Syslog. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCESYSLOG e creare una tabella hash.

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

-DataSourceWindowsEventLog

Elenco delle configurazioni dell'origine dati del registro eventi di Windows. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCEWINDOW edizione Standard VENTLOG e creare una tabella hash.

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

-DataSourceWindowsFirewallLog

Elenco delle configurazioni di origine dei log di Windows Firewall. Per costruire, vedere la sezione NOTES per le proprietà DATASOURCEWINDOWSFIREWALLLOG e creare una tabella hash.

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

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

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

-Description

Descrizione della regola di raccolta dati.

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

-DestinationAzureMonitorMetricName

Nome descrittivo per la destinazione. Questo nome deve essere univoco in tutte le destinazioni (indipendentemente dal tipo) all'interno della regola di raccolta dati.

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

-DestinationEventHub

Elenco delle destinazioni di Hub eventi. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONEVENTHUB e creare una tabella hash.

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

-DestinationEventHubsDirect

Elenco delle destinazioni dirette di Hub eventi. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONEVENTHUBSDIRECT e creare una tabella hash.

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

-DestinationLogAnalytic

Elenco delle destinazioni di Log Analytics. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONLOGANALYTIC e creare una tabella hash.

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

-DestinationMonitoringAccount

Elenco delle destinazioni dell'account di monitoraggio. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONMONITORINGACCOUNT e creare una tabella hash.

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

-DestinationStorageAccount

Elenco delle destinazioni degli account di archiviazione. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONSTORAGEACCOUNT e creare una tabella hash.

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

-DestinationStorageBlobsDirect

Elenco delle destinazioni Archiviazione Blob Direct. Da usare solo per l'invio di dati direttamente da archiviare dall'agente. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONSTORAGEBLOBSDIRECT e creare una tabella hash.

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

-DestinationStorageTablesDirect

Elenco delle destinazioni Archiviazione Table Direct. Per costruire, vedere la sezione NOTES per le proprietà DESTINATIONSTORAGETABLESDIRECT e creare una tabella hash.

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

-IdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

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

-InputObject

Parametro Identity Per costruire, vedere la sezione NOTES per le proprietà INPUTOBJECT e creare una tabella hash.

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

-Kind

Tipo di risorsa.

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

-Location

Posizione geografica in cui risiede la risorsa.

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

-Name

Nome della regola di raccolta dati. Il nome non fa distinzione tra maiuscole e minuscole.

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

-ResourceGroupName

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

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

-StreamDeclaration

Dichiarazione di flussi personalizzati usati in questa regola.

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

-SubscriptionId

ID della sottoscrizione di destinazione.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Tag di risorsa.

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

-UserAssignedIdentity

Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

IDataCollectionRuleIdentity

Output

IDataCollectionRuleResource