New-AzServiceBusQueue
Cria ou atualiza uma fila do Barramento de Serviço. Esta operação é 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
Cria ou atualiza uma fila do Barramento de Serviço. Esta operação é idempotente.
Exemplos
Exemplo 1: Criar uma nova fila do 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 : ActiveCria uma fila myQueue ServiceBus no namespace myNamespace.
Parâmetros
-AutoDeleteOnIdle
Intervalo ocioso após o qual a fila é excluída automaticamente. A duração mínima é de 5 minutos.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadLetteringOnMessageExpiration
Um valor que indica se essa fila tem suporte a letras mortas quando uma mensagem expira.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultMessageTimeToLive
Esta é a duração após a qual a mensagem expira, a partir de quando a mensagem é enviada para o Service Bus. Esse é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
| Type: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DuplicateDetectionHistoryTimeWindow
Define a duração do histórico de detecção de duplicatas. O valor padrão é 10 minutos.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBatchedOperations
Valor que indica se as operações em lote do lado do servidor estão habilitadas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableExpress
Um valor que indica se as Entidades Expressas estão habilitadas. Uma fila expressa mantém uma mensagem na memória temporariamente antes de gravá-la no armazenamento persistente.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnablePartitioning
Um valor que indica se a fila deve ser particionada em vários agentes de mensagens.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForwardDeadLetteredMessagesTo
Nome da fila/tópico para encaminhar a mensagem de letra morta
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForwardTo
Nome da fila/tópico para encaminhar as mensagens
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LockDuration
Duração do período de tempo de um peek-lock; ou seja, a quantidade de tempo que a mensagem fica bloqueada para outros receptores. O valor máximo para LockDuration é de 5 minutos; O valor padrão é 1 minuto.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxDeliveryCount
A contagem máxima de entregas. Uma mensagem é automaticamente deadlettered após esse número de entregas. O valor padrão é 10.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxMessageSizeInKilobytes
Tamanho máximo (em KB) da carga útil da mensagem que pode ser aceita pela fila. Essa propriedade só é usada no Premium hoje e o padrão é 1024.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxSizeInMegabytes
O tamanho máximo da fila em megabytes, que é o tamanho da memória alocada para a fila. O padrão é 1024.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
O nome da fila.
| Type: | String |
| Aliases: | QueueName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NamespaceName
O nome do namespace
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiresDuplicateDetection
Um valor que indica se essa fila requer detecção duplicada.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiresSession
Um valor que indica se a fila oferece suporte ao conceito de sessões.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Nome do grupo de recursos na assinatura do Azure.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Status
Enumera os valores possíveis para o status de uma entidade de mensagens.
| Type: | EntityStatus |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
| Type: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Saídas
Observações
ALIASES