New-AzServiceBusQueue
criar uma fila do Barramento de Serviço.
Esta operação é idempotente.
Sintaxe
CreateExpanded (Default)
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 <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityNamespaceExpanded
New-AzServiceBusQueue
-Name <String>
-NamespaceInputObject <IServiceBusIdentity>
[-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 <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityNamespace
New-AzServiceBusQueue
-Name <String>
-NamespaceInputObject <IServiceBusIdentity>
-Parameter <ISbQueue>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
criar 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 : Active
Cria uma fila myQueue do ServiceBus no namespace myNamespace.
Parâmetros
-AutoDeleteOnIdle
Intervalo de ociosidade após o qual a fila é excluída automaticamente.
A duração mínima é de 5 minutos.
Propriedades do parâmetro
Tipo: TimeSpan
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Aliases: cf
Conjuntos de parâmetros
(All)
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-DeadLetteringOnMessageExpiration
Um valor que indica se essa fila tem suporte a mensagens mortas quando uma mensagem expira.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-DefaultMessageTimeToLive
Essa é a duração após a qual a mensagem expira, começando de quando a mensagem é enviada ao Barramento de Serviço.
Esse é o valor padrão usado quando TimeToLive não é definido em uma mensagem em si.
Propriedades do parâmetro
Tipo: TimeSpan
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: 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.
Propriedades do parâmetro
Tipo: PSObject
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Aliases: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-DuplicateDetectionHistoryTimeWindow
Define a duração do histórico de detecção duplicado.
O valor padrão é 10 minutos.
Propriedades do parâmetro
Tipo: TimeSpan
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-EnableBatchedOperations
Valor que indica se as operações em lote do lado do servidor estão habilitadas.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: 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 escrevê-la no armazenamento persistente.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-EnablePartitioning
Um valor que indica se a fila deve ser particionada em vários agentes de mensagens.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-ForwardDeadLetteredMessagesTo
Nome da fila/tópico para encaminhar a mensagem de Carta Morta
Propriedades do parâmetro
Tipo: String
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-ForwardTo
Nome da fila/tópico para encaminhar as mensagens
Propriedades do parâmetro
Tipo: String
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-LockDuration
Duração do tempo limite de um peek-lock; ou seja, a quantidade de tempo que a mensagem está bloqueada para outros receptores.
O valor máximo para LockDuration é de 5 minutos; o valor padrão é 1 minuto.
Propriedades do parâmetro
Tipo: TimeSpan
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-MaxDeliveryCount
A contagem máxima de entrega.
Uma mensagem é automaticamente morta após esse número de entregas.
o valor padrão é 10.
Propriedades do parâmetro
Tipo: Int32
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-MaxMessageSizeInKilobytes
Tamanho máximo (em KB) do conteúdo da mensagem que pode ser aceito pela fila.
Essa propriedade é usada apenas no Premium hoje e o padrão é 1024.
Propriedades do parâmetro
Tipo: Int64
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-MaxSizeInMegabytes
O tamanho máximo da fila em megabytes, que é o tamanho da memória alocada para a fila.
O padrão é 1024.
Propriedades do parâmetro
Tipo: Int32
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-Name
O nome da fila.
Propriedades do parâmetro
Tipo: String
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Aliases: QueueName
Conjuntos de parâmetros
(All)
Cargo: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
Parâmetro de identidade
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespace
Cargo: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-NamespaceName
O nome do namespace
Propriedades do parâmetro
Tipo: String
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-Parameter
Descrição do recurso queue.
Propriedades do parâmetro
Tipo: ISbQueue
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateViaIdentityNamespace
Cargo: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-RequiresDuplicateDetection
Um valor que indica se essa fila requer detecção duplicada.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-RequiresSession
Um valor que indica se a fila dá suporte ao conceito de sessões.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-ResourceGroupName
Nome do grupo de recursos na assinatura do Azure.
Propriedades do parâmetro
Tipo: String
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-Status
Enumera os valores possíveis para o status de uma entidade de mensagens.
Propriedades do parâmetro
Tipo: String
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: 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.
Propriedades do parâmetro
Tipo: String
Valor padrão: (Get-AzContext).Subscription.Id
Dá suporte a curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None
Dá suporte a curingas: False
DontShow: False
Aliases: wi
Conjuntos de parâmetros
(All)
Cargo: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline pelo nome da propriedade: False
Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas