Partager via


Update-AzDataCollectionRule

Mettez à jour une règle de collecte de données.

Syntaxe

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>]
      [-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>]
      [-StreamDeclaration <Hashtable>]
      [-Tag <Hashtable>]
      [-UserAssignedIdentity <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Mettez à jour une règle de collecte de données.

Exemples

Exemple 1 : Mettre à jour la balise pour la règle de collecte de données

$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

Cette commande met à jour la règle de collecte de données.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataCollectionEndpointId

ID de ressource du point de terminaison de collecte de données avec lequel cette règle peut être utilisée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataFlow

Spécification des flux de données.

Type:IDataFlow[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceDataImportEventHubConsumerGroup

Nom du groupe de consommateurs Event Hub

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceDataImportEventHubName

Nom convivial de la source de données. Ce nom doit être unique dans toutes les sources de données (quel que soit le type) dans la règle de collecte de données.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceDataImportEventHubStream

Flux à collecter à partir d’EventHub

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceExtension

Liste des configurations de source de données d’extension de machine virtuelle Azure.

Type:IExtensionDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceIisLog

Liste des configurations sources des journaux IIS.

Type:IIisLogsDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceLogFile

Liste des configurations sources des fichiers journaux.

Type:ILogFilesDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourcePerformanceCounter

Liste des configurations de source de données du compteur de performances.

Type:IPerfCounterDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourcePlatformTelemetry

Liste des configurations de télémétrie de plateforme

Type:IPlatformTelemetryDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourcePrometheusForwarder

Liste des configurations de source de données du redirecteur Prometheus.

Type:IPrometheusForwarderDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceSyslog

Liste des configurations de source de données Syslog.

Type:ISyslogDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceWindowsEventLog

Liste des configurations de source de données du journal des événements Windows.

Type:IWindowsEventLogDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataSourceWindowsFirewallLog

Liste des configurations sources du pare-feu Windows.

Type:IWindowsFirewallLogsDataSource[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Type:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Description de la règle de collecte de données.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationAzureMonitorMetricName

Nom convivial de la destination. Ce nom doit être unique sur toutes les destinations (quel que soit le type) dans la règle de collecte de données.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationEventHub

Liste des destinations Event Hubs.

Type:IEventHubDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationEventHubsDirect

Liste des destinations Event Hubs Direct.

Type:IEventHubDirectDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationLogAnalytic

Liste des destinations Log Analytics.

Type:ILogAnalyticsDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationMonitoringAccount

Liste des destinations de compte de surveillance.

Type:IMonitoringAccountDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationStorageAccount

Liste des destinations des comptes de stockage.

Type:IStorageBlobDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationStorageBlobsDirect

Liste des destinations Blob Direct du stockage. Pour être utilisé uniquement pour l’envoi de données directement à stocker à partir de l’agent.

Type:IStorageBlobDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationStorageTablesDirect

Liste des destinations directes de table de stockage.

Type:IStorageTableDestination[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Paramètre d’identité

Type:IDataCollectionRuleIdentity
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Kind

Type de ressource.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Nom de la règle de collecte de données. Le nom ne respecte pas la casse.

Type:String
Alias:DataCollectionRuleName, RuleName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StreamDeclaration

Déclaration de flux personnalisés utilisés dans cette règle.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubscriptionId

ID de l’abonnement cible.

Type:String
Position:Named
Valeur par défaut:(Get-AzContext).Subscription.Id
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Balises de ressource.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserAssignedIdentity

Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

IDataCollectionRuleIdentity

Sorties

IDataCollectionRuleResource