New-AzEventHub
créez un hub d’événements en tant que ressource imbriquée dans un espace de noms.
Syntaxe
CreateExpanded (Par défaut)
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
créez un hub d’événements en tant que ressource imbriquée dans un espace de noms.
Exemples
Exemple 1 : Créer une entité 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
Crée une entité myEventHub eventhub sur l’espace de noms myNamespace avec CleanupPolicy Delete.
Exemple 2 : Créer EventHub avec capture activée
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
Crée une entité myEventHub eventhub sur l’espace de noms myNamespace avec la capture activée.
Exemple 3 : Créer une entité 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
Crée une entité myEventHub eventhub sur l’espace de noms myNamespace avec CleanupPolicy Compact.
Paramètres
Convention d’affectation de noms d’objets blob pour l’archivage, par exemple {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}.
Ici, tous les paramètres (Espace de noms,EventHub .. etc.) sont obligatoires, quel que soit l’ordre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-BlobContainer
Nom du conteneur d’objets blob
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-CaptureEnabled
Valeur qui indique si la description de capture est activée.
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
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-CleanupPolicy
Énumère les valeurs possibles pour la stratégie de nettoyage
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-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
-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
-DestinationName
Nom de la destination de capture
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Encoding
Énumère les valeurs possibles pour le format d’encodage de la description de capture.
Remarque : « AvroDeflate » sera déconseillé dans la nouvelle version de l’API
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-IdentityType
Type d’identité managée Azure Active Directory.
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-IntervalInSeconds
La fenêtre de temps vous permet de définir la fréquence à laquelle la capture est effectuée sur les objets blob Azure, la valeur doit être comprise entre 60 et 900 secondes.
Propriétés du paramètre
Type: Int32
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-MinCompactionLagInMin
La durée minimale pendant laquelle un message restera inéligible pour le compactage dans le journal.
Cette valeur est utilisée lorsque cleanupPolicy est Compact ou DeleteOrCompact.
Propriétés du paramètre
Type: Int64
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Name
Nom du hub d’événements
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: EventHubName
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
Paramètre d’identité
Type: IEventHubIdentity
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespace
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-NamespaceName
Nom de l’espace de noms
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
CreateExpanded
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Parameter
Élément unique dans l’opération List ou Get Event Hub
Propriétés du paramètre
Type: IEventhub
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateViaIdentityNamespace
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-PartitionCount
Nombre de partitions créées pour le hub d’événements, les valeurs autorisées sont comprises entre 1 et 32 partitions.
Propriétés du paramètre
Type: Int64
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ResourceGroupName
Nom du groupe de ressources dans l’abonnement Azure.
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
CreateExpanded
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-RetentionTimeInHour
Nombre d’heures de conservation des événements pour ce hub d’événements.
Il doit s’agir d’une valeur positive maximale de référence SKU d’espace de noms. -1 est un cas particulier où le temps de rétention est infini, mais la taille d’une entité est limitée et sa taille dépend du type de référence SKU d’espace de noms.
Propriétés du paramètre
Type: Int64
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-SizeLimitInBytes
La fenêtre de taille définit la quantité de données générées dans votre Event Hub avant une opération de capture, la valeur doit être comprise entre 10485760 et 524288000 octets
Propriétés du paramètre
Type: Int32
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-SkipEmptyArchive
Valeur qui indique s’il faut ignorer les archives vides
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
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Status
Énumère les valeurs possibles pour l’état du hub d’événements.
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-StorageAccountResourceId
ID de ressource du compte de stockage à utiliser pour créer les objets blob
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-SubscriptionId
Informations d’identification d’abonnement qui identifient de manière unique un abonnement Microsoft Azure.
L’ID d’abonnement fait partie de l’URI de chaque appel de service.
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-TimestampType
Indique le type d’horodatage que le message contiendra. Deux types d’horodatages : « AppendTime » et « CreateTime ».
AppendTime fait référence à l’heure dans laquelle le message a été ajouté dans le journal broker.
CreateTime fait référence à l’heure dans laquelle le message a été généré côté source et les producteurs peuvent définir cet horodatage lors de l’envoi du message.
La valeur par défaut est AppendTime.
Si vous utilisez le protocole AMQP, CreateTime est égal à AppendTime et son comportement reste le même.
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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-TombstoneRetentionTimeInHour
Nombre d’heures pour conserver les marqueurs tombstone d’un hub d’événements compacté.
Cette valeur est utilisée lorsque cleanupPolicy est Compact ou DeleteOrCompact.
Le consommateur doit terminer la lecture du marqueur tombstone dans ce délai spécifié si le consommateur commence à démarrer le décalage pour s’assurer qu’il obtient un instantané valide pour la clé spécifique décrite par le marqueur tombstone dans le hub d’événements compacté
Propriétés du paramètre
Type: Int32
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-UserAssignedIdentityId
ID ARM de l’identité utilisateur managée.
Cette propriété est obligatoire est le type UserAssignedIdentity.
Si le type est SystemAssigned, l’identité affectée par le système associée à l’espace de noms est 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
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
Obtient et définit les métadonnées de l’utilisateur.
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
CreateExpanded
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CreateViaIdentityNamespaceExpanded
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 .
Sorties
