Partager via

Update-AzDataCollectionRule

Module:
Az.Monitor Module

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

Syntaxe

UpdateExpanded (Par défaut) 

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

UpdateViaIdentityExpanded 

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[]>]
    [-EnableSystemAssignedIdentity <Boolean>]
    [-Kind <String>]
    [-StreamDeclaration <Hashtable>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-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 invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataCollectionEndpointId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataFlow

Spécification des flux de données.

Propriétés du paramètre

Type:

IDataFlow[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceDataImportEventHubConsumerGroup

Nom du groupe de consommateurs Event Hub

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceDataImportEventHubStream

Flux à collecter à partir d’EventHub

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceExtension

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

Propriétés du paramètre

Type:

IExtensionDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceIisLog

Liste des configurations sources des journaux IIS.

Propriétés du paramètre

Type:

IIisLogsDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceLogFile

Liste des configurations sources des fichiers journaux.

Propriétés du paramètre

Type:

ILogFilesDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourcePerformanceCounter

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

Propriétés du paramètre

Type:

IPerfCounterDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourcePlatformTelemetry

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

Propriétés du paramètre

Type:

IPlatformTelemetryDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourcePrometheusForwarder

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

Propriétés du paramètre

Type:

IPrometheusForwarderDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceSyslog

Liste des configurations de source de données Syslog.

Propriétés du paramètre

Type:

ISyslogDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceWindowsEventLog

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

Propriétés du paramètre

Type:

IWindowsEventLogDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataSourceWindowsFirewallLog

Liste des configurations sources du pare-feu Windows.

Propriétés du paramètre

Type:

IWindowsFirewallLogsDataSource[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Description

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DestinationEventHub

Liste des destinations Event Hubs.

Propriétés du paramètre

Type:

IEventHubDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DestinationEventHubsDirect

Liste des destinations Event Hubs Direct.

Propriétés du paramètre

Type:

IEventHubDirectDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DestinationLogAnalytic

Liste des destinations de journal Analytique.

Propriétés du paramètre

Type:

ILogAnalyticsDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DestinationMonitoringAccount

Liste des destinations de compte de surveillance.

Propriétés du paramètre

Type:

IMonitoringAccountDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DestinationStorageAccount

Liste des destinations des comptes de stockage.

Propriétés du paramètre

Type:

IStorageBlobDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

IStorageBlobDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DestinationStorageTablesDirect

Liste des destinations directes de table de stockage.

Propriétés du paramètre

Type:

IStorageTableDestination[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EnableSystemAssignedIdentity

Détermine s’il faut activer une identité affectée par le système pour la ressource.

Propriétés du paramètre

Type:

Nullable<T>[Boolean]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputObject

Paramètre d’identité

Propriétés du paramètre

Type:IDataCollectionRuleIdentity
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UpdateViaIdentityExpanded
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Kind

Type de ressource.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:DataCollectionRuleName, Nom de la Règle

Jeux de paramètres

UpdateExpanded
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UpdateExpanded
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StreamDeclaration

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

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SubscriptionId

ID de l’abonnement cible.

Propriétés du paramètre

Type:String
Valeur par défaut:(Get-AzContext).Subscription.Id
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UpdateExpanded
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Balises de ressource.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UserAssignedIdentity

Tableau d’identités affectées par l’utilisateur associées à la ressource. Les éléments du tableau seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. »

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

IDataCollectionRuleIdentity

Sorties

IDataCollectionRuleResource