New-AzServiceBusQueue
Crea o actualiza una cola de Service Bus. Esta operación es idempotente.
Syntax
New-AzServiceBusQueue
-Name <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-AutoDeleteOnIdle <TimeSpan>]
[-DeadLetteringOnMessageExpiration]
[-DefaultMessageTimeToLive <TimeSpan>]
[-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
[-EnableBatchedOperations]
[-EnableExpress]
[-EnablePartitioning]
[-ForwardDeadLetteredMessagesTo <String>]
[-ForwardTo <String>]
[-LockDuration <TimeSpan>]
[-MaxDeliveryCount <Int32>]
[-MaxMessageSizeInKilobytes <Int64>]
[-MaxSizeInMegabytes <Int32>]
[-RequiresDuplicateDetection]
[-RequiresSession]
[-Status <EntityStatus>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Crea o actualiza una cola de Service Bus. Esta operación es idempotente.
Ejemplos
Ejemplo 1: Crear una nueva cola de ServiceBus
New-AzServiceBusQueue -ResourceGroupName myResourceGroup -NamespaceName myNamespace -Name myQueue -AutoDeleteOnIdle (New-TimeSpan -Days 1 -Minutes 3 -Seconds 4) -DefaultMessageTimeToLive (New-TimeSpan -Days 5) -EnablePartitioning
AccessedAt : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle : 1.00:03:04
CountDetailActiveMessageCount : 0
CountDetailDeadLetterMessageCount : 0
CountDetailScheduledMessageCount : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount : 0
CreatedAt : 9/22/2022 12:30:45 PM
DeadLetteringOnMessageExpiration : False
DefaultMessageTimeToLive : 5.00:00:00
DuplicateDetectionHistoryTimeWindow : 00:10:00
EnableBatchedOperations : True
EnableExpress : False
EnablePartitioning : True
ForwardDeadLetteredMessagesTo :
ForwardTo :
Id : /subscriptions/326100e2-f69d-4268-8503-075374f62b6e/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/queues/myQueue
Location : westus
LockDuration : 00:01:00
MaxDeliveryCount : 10
MaxMessageSizeInKilobytes : 1024
MaxSizeInMegabytes : 1024
MessageCount : 0
Name : myQueue
RequiresDuplicateDetection : False
RequiresSession : False
ResourceGroupName : myResourceGroup
SizeInByte : 0
Status : Active
Crea una cola myQueue
de ServiceBus en el espacio de nombres myNamespace
.
Parámetros
-AutoDeleteOnIdle
Intervalo de inactividad después del cual se elimina automáticamente la cola. La duración mínima es de 5 minutos.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadLetteringOnMessageExpiration
Valor que indica si esta cola tiene compatibilidad con mensajes fallidos cuando expira un mensaje.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultMessageTimeToLive
Esta es la duración después de la cual expira el mensaje, a partir de cuándo se envía el mensaje a Service Bus. Este es el valor predeterminado que se usa cuando TimeToLive no está establecido en un mensaje en sí.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DuplicateDetectionHistoryTimeWindow
Define la duración del historial de detección de duplicados. El valor predeterminado es 10 minutos.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableBatchedOperations
Valor que indica si las operaciones por lotes del lado servidor están habilitadas.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableExpress
Valor que indica si las entidades express están habilitadas. Una cola rápida contiene un mensaje en la memoria temporalmente antes de escribirlo en el almacenamiento persistente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnablePartitioning
Valor que indica si la cola se va a particionar entre varios agentes de mensajes.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForwardDeadLetteredMessagesTo
Nombre de la cola o tema para reenviar el mensaje de mensajes fallidos
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForwardTo
Nombre de cola o tema para reenviar los mensajes
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LockDuration
Duración del intervalo de tiempo de un bloqueo de inspección; es decir, la cantidad de tiempo que el mensaje está bloqueado para otros receptores. El valor máximo de LockDuration es de 5 minutos; el valor predeterminado es 1 minuto.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxDeliveryCount
Número máximo de entregas. Un mensaje se activa automáticamente después de este número de entregas. el valor predeterminado es 10.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxMessageSizeInKilobytes
Tamaño máximo (en KB) de la carga del mensaje que la cola puede aceptar. Esta propiedad solo se usa actualmente en Premium y el valor predeterminado es 1024.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSizeInMegabytes
Tamaño máximo de la cola en megabytes, que es el tamaño de la memoria asignada para la cola. El valor predeterminado es 1024.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Nombre de cola.
Type: | String |
Aliases: | QueueName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NamespaceName
Nombre del espacio de nombres
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiresDuplicateDetection
Valor que indica si esta cola requiere detección de duplicados.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiresSession
Valor que indica si la cola admite el concepto de sesiones.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nombre del grupo de recursos dentro de la suscripción de Azure.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
Enumera los valores posibles para el estado de una entidad de mensajería.
Type: | EntityStatus |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 para cada llamada al servicio.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Salidas
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de