Compartir a través de

Update-AzDataCollectionRule

Módulo:
Az.Monitor Module

Actualice una regla de recopilación de datos.

Sintaxis

UpdateExpanded (valor predeterminado) 

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

Actualice una regla de recopilación de datos.

Ejemplos

Ejemplo 1: Actualización de la etiqueta para la regla de recopilación de datos

$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

Este comando actualiza la regla de recopilación de datos.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataCollectionEndpointId

Identificador de recurso del punto de conexión de recopilación de datos con el que se puede usar esta regla.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataFlow

Especificación de flujos de datos.

Propiedades de parámetro

Tipo:

IDataFlow[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceDataImportEventHubConsumerGroup

Nombre del grupo de consumidores del centro de eventos

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceDataImportEventHubName

Nombre descriptivo para el origen de datos. Este nombre debe ser único en todos los orígenes de datos (independientemente del tipo) dentro de la regla de recopilación de datos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceDataImportEventHubStream

Secuencia que se va a recopilar de EventHub

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceExtension

Lista de configuraciones de orígenes de datos de extensión de máquina virtual de Azure.

Propiedades de parámetro

Tipo:

IExtensionDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceIisLog

La lista de configuraciones de origen de registros de IIS.

Propiedades de parámetro

Tipo:

IIisLogsDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceLogFile

Lista de configuraciones de origen de archivos de registro.

Propiedades de parámetro

Tipo:

ILogFilesDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourcePerformanceCounter

Lista de configuraciones del origen de datos del contador de rendimiento.

Propiedades de parámetro

Tipo:

IPerfCounterDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourcePlatformTelemetry

Lista de configuraciones de telemetría de plataforma

Propiedades de parámetro

Tipo:

IPlatformTelemetryDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourcePrometheusForwarder

Lista de configuraciones de origen de datos del reenviador de Prometheus.

Propiedades de parámetro

Tipo:

IPrometheusForwarderDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceSyslog

Lista de configuraciones de origen de datos de Syslog.

Propiedades de parámetro

Tipo:

ISyslogDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceWindowsEventLog

Lista de configuraciones de origen de datos del registro de eventos de Windows.

Propiedades de parámetro

Tipo:

IWindowsEventLogDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataSourceWindowsFirewallLog

La lista de configuraciones de origen de registros del Firewall de Windows.

Propiedades de parámetro

Tipo:

IWindowsFirewallLogsDataSource[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Propiedades de parámetro

Tipo:PSObject
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

Descripción de la regla de recopilación de datos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationAzureMonitorMetricName

Nombre descriptivo para el destino. Este nombre debe ser único en todos los destinos (independientemente del tipo) dentro de la regla de recopilación de datos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationEventHub

Lista de destinos de Event Hubs.

Propiedades de parámetro

Tipo:

IEventHubDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationEventHubsDirect

Lista de destinos directos de Event Hubs.

Propiedades de parámetro

Tipo:

IEventHubDirectDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationLogAnalytic

Lista de destinos de Log Analytics.

Propiedades de parámetro

Tipo:

ILogAnalyticsDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationMonitoringAccount

Lista de destinos de cuenta de supervisión.

Propiedades de parámetro

Tipo:

IMonitoringAccountDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationStorageAccount

Lista de destinos de cuentas de almacenamiento.

Propiedades de parámetro

Tipo:

IStorageBlobDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationStorageBlobsDirect

Lista de destinos de Storage Blob Direct. Para usarse solo para enviar datos directamente para almacenarlos desde el agente.

Propiedades de parámetro

Tipo:

IStorageBlobDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DestinationStorageTablesDirect

Lista de destinos de Storage Table Direct.

Propiedades de parámetro

Tipo:

IStorageTableDestination[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EnableSystemAssignedIdentity

Determina si se va a habilitar una identidad asignada por el sistema para el recurso.

Propiedades de parámetro

Tipo:

Nullable<T>[Boolean]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

Parámetro de identidad

Propiedades de parámetro

Tipo:IDataCollectionRuleIdentity
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UpdateViaIdentityExpanded
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Kind

Tipo del recurso.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre de la regla de recopilación de datos. El nombre distingue mayúsculas de minúsculas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:DataCollectionRuleName, Nombre de la Regla

Conjuntos de parámetros

UpdateExpanded
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UpdateExpanded
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StreamDeclaration

Declaración de flujos personalizados usados en esta regla.

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SubscriptionId

Identificador de la suscripción de destino.

Propiedades de parámetro

Tipo:String
Valor predeterminado:(Get-AzContext).Subscription.Id
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UpdateExpanded
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Tag

Etiquetas de recursos.

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserAssignedIdentity

Matriz de identidades asignadas por el usuario asociadas al recurso. Los elementos de la matriz serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.'

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

IDataCollectionRuleIdentity

Salidas

IDataCollectionRuleResource