New-AzEventHub
cree un nuevo centro de eventos como un recurso anidado dentro de un espacio de nombres.
Sintaxis
CreateExpanded (valor predeterminado)
New-AzEventHub
-Name <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-ArchiveNameFormat <String>]
[-BlobContainer <String>]
[-CaptureEnabled]
[-CleanupPolicy <String>]
[-DestinationName <String>]
[-Encoding <String>]
[-IdentityType <String>]
[-IntervalInSeconds <Int32>]
[-MinCompactionLagInMin <Int64>]
[-PartitionCount <Int64>]
[-RetentionTimeInHour <Int64>]
[-SizeLimitInBytes <Int32>]
[-SkipEmptyArchive]
[-Status <String>]
[-StorageAccountResourceId <String>]
[-TimestampType <String>]
[-TombstoneRetentionTimeInHour <Int32>]
[-UserAssignedIdentityId <String>]
[-UserMetadata <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityNamespaceExpanded
New-AzEventHub
-Name <String>
-NamespaceInputObject <IEventHubIdentity>
[-ArchiveNameFormat <String>]
[-BlobContainer <String>]
[-CaptureEnabled]
[-CleanupPolicy <String>]
[-DestinationName <String>]
[-Encoding <String>]
[-IdentityType <String>]
[-IntervalInSeconds <Int32>]
[-MinCompactionLagInMin <Int64>]
[-PartitionCount <Int64>]
[-RetentionTimeInHour <Int64>]
[-SizeLimitInBytes <Int32>]
[-SkipEmptyArchive]
[-Status <String>]
[-StorageAccountResourceId <String>]
[-TimestampType <String>]
[-TombstoneRetentionTimeInHour <Int32>]
[-UserAssignedIdentityId <String>]
[-UserMetadata <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityNamespace
New-AzEventHub
-Name <String>
-NamespaceInputObject <IEventHubIdentity>
-Parameter <IEventhub>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
cree un nuevo centro de eventos como un recurso anidado dentro de un espacio de nombres.
Ejemplos
Ejemplo 1: Creación de una entidad de EventHub
New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -RetentionTimeInHour 168 -PartitionCount 5 -CleanupPolicy Delete
ArchiveNameFormat :
BlobContainer :
CaptureEnabled :
CleanupPolicy : Delete
CreatedAt : 4/25/2023 3:55:45 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName :
Encoding :
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds :
Location : eastus
MessageRetentionInDay : 7
Name : myEventHub
PartitionCount : 5
PartitionId : {0, 1, 2, 3�}
ResourceGroupName : myResourceGroup
RetentionTimeInHour : 168
SizeLimitInBytes :
SkipEmptyArchive :
Status : Active
StorageAccountResourceId :
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt : 4/25/2023 3:55:46 AM
Crea una nueva entidad myEventHub de centro de eventos en el espacio de nombres myNamespace con CleanupPolicy Delete.
Ejemplo 2: Creación de EventHub con captura habilitada
New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -ArchiveNameFormat "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}" -BlobContainer container -CaptureEnabled -DestinationName EventHubArchive.AzureBlockBlob -Encoding Avro -IntervalInSeconds 600 -SizeLimitInBytes 11000000 -SkipEmptyArchive -StorageAccountResourceId "/subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount -CleanupPolicy Delete"
ArchiveNameFormat : {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}
BlobContainer : container
CaptureEnabled : true
CreatedAt : 9/1/2022 5:55:46 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName :
Encoding : Avro
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myFirstEventHub
IntervalInSeconds : 600
Location : centralus
MessageRetentionInDays : 6
Name : myFirstEventHub
PartitionCount : 5
PartitionId : {0}
ResourceGroupName : myResourceGroup
RetentionTimeInHour : 24
SizeLimitInBytes : 11000000
SkipEmptyArchive : true
Status : Active
Crea una nueva entidad myEventHub de centro de eventos en el espacio de nombres myNamespace con la captura habilitada.
Ejemplo 3: Creación de una entidad de EventHub
New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -CleanupPolicy Compact
ArchiveNameFormat :
BlobContainer :
CaptureEnabled :
CleanupPolicy : Compact
CreatedAt : 4/25/2023 4:05:57 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName :
Encoding :
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds :
Location : eastus
MessageRetentionInDay : 9223372036854775807
Name : myEventHub
PartitionCount : 4
PartitionId : {0, 1, 2, 3}
ResourceGroupName : myResourceGroup
RetentionTimeInHour :
SizeLimitInBytes :
SkipEmptyArchive :
Status : Active
StorageAccountResourceId :
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt : 4/25/2023 4:05:58 AM
Crea una nueva entidad myEventHub de centro de eventos en el espacio de nombres myNamespace con CleanupPolicy Compact.
Parámetros
Convención de nomenclatura de blobs para el archivo, por ejemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}.
Aquí todos los parámetros (espacio de nombres, EventHub, etc.) son obligatorios independientemente del orden.
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-BlobContainer
Nombre del contenedor de blobs
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-CaptureEnabled
Valor que indica si la descripción de captura está habilitada.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-CleanupPolicy
Enumera los valores posibles para la directiva de limpieza
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-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
-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
-DestinationName
Nombre del destino de captura
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-Encoding
Enumera los valores posibles para el formato de codificación de la descripción de captura.
Nota: "AvroDeflate" quedará en desuso en la nueva versión de LA API
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-IdentityType
Tipo de identidad administrada de Azure Active Directory.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-IntervalInSeconds
El período de tiempo le permite establecer la frecuencia con la que se producirá la captura en blobs de Azure, el valor debe estar comprendido entre 60 y 900 segundos.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-MinCompactionLagInMin
El tiempo mínimo que un mensaje permanecerá inelegible para la compactación en el registro.
Este valor se usa cuando cleanupPolicy es Compact o DeleteOrCompact.
Propiedades de parámetro
Tipo: Int64
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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 del centro de eventos
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: EventHubName
Conjuntos de parámetros
(All)
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
Parámetro de identidad
Tipo: IEventHubIdentity
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityNamespace
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
-NamespaceName
Nombre del espacio de nombres
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
-Parameter
Elemento único en la operación List or Get Event Hubs
Propiedades de parámetro
Tipo: IEventhub
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateViaIdentityNamespace
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
-PartitionCount
Número de particiones creadas para el centro de eventos, los valores permitidos son de 1 a 32 particiones.
Propiedades de parámetro
Tipo: Int64
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-ResourceGroupName
Nombre del grupo de recursos dentro de la suscripción de Azure.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
-RetentionTimeInHour
Número de horas para conservar los eventos de este centro de eventos.
Debe ser un valor positivo hasta el máximo de SKU del espacio de nombres. -1 es un caso especial en el que el tiempo de retención es infinito, pero el tamaño de una entidad está restringido y su tamaño depende del tipo de SKU del espacio de nombres.
Propiedades de parámetro
Tipo: Int64
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-SizeLimitInBytes
La ventana de tamaño define la cantidad de datos integrados en el centro de eventos antes de una operación de captura, el valor debe estar entre 10485760 a 524288000 bytes.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-SkipEmptyArchive
Valor que indica si se omitirán los archivos vacíos.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-Status
Enumera los valores posibles para el estado del centro de eventos.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-StorageAccountResourceId
Identificador de recurso de la cuenta de almacenamiento que se va a usar para crear los blobs
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure.
El identificador de suscripción forma parte del URI de cada llamada de servicio.
Propiedades de parámetro
Tipo: String
Valor predeterminado: (Get-AzContext).Subscription.Id Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
-TimestampType
Indica el tipo de marca de tiempo que contendrá el mensaje. Dos tipos de tipos de marca de tiempo: "AppendTime" y "CreateTime".
AppendTime hace referencia a la hora en la que se anexó el mensaje dentro del registro del agente.
CreateTime hace referencia a la hora en la que se generó el mensaje en el lado de origen y los productores pueden establecer esta marca de tiempo al enviar el mensaje.
El valor predeterminado es AppendTime.
Si usa el protocolo AMQP, CreateTime es igual a AppendTime y su comportamiento sigue siendo el mismo.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-TombstoneRetentionTimeInHour
Número de horas para conservar los marcadores de lápiz de un centro de eventos compacto.
Este valor se usa cuando cleanupPolicy es Compact o DeleteOrCompact.
El consumidor debe completar la lectura del marcador de lápiz dentro de esta cantidad de tiempo especificada si el consumidor comienza desde el desplazamiento inicial para asegurarse de que obtienen una instantánea válida para la clave específica descrita por el marcador de lápiz dentro del centro de eventos compactado.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
-UserAssignedIdentityId
Id. de ARM de identidad de usuario administrado.
Esta propiedad es necesaria es userAssignedIdentity.
Si el tipo es SystemAssigned, se usará la identidad asignada por el sistema asociada al espacio de nombres.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
Obtiene y establece los metadatos del usuario.
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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 .
Salidas
