New-AzServiceBusSubscription
Crie uma assinatura de tópico.
Sintaxe
CreateExpanded (Padrão)
New-AzServiceBusSubscription
-Name <String>
-NamespaceName <String>
-ResourceGroupName <String>
-TopicName <String>
[-SubscriptionId <String>]
[-AutoDeleteOnIdle <TimeSpan>]
[-ClientId <String>]
[-DeadLetteringOnFilterEvaluationException]
[-DeadLetteringOnMessageExpiration]
[-DefaultMessageTimeToLive <TimeSpan>]
[-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
[-EnableBatchedOperations]
[-ForwardDeadLetteredMessagesTo <String>]
[-ForwardTo <String>]
[-IsClientAffine]
[-IsDurable]
[-IsShared]
[-LockDuration <TimeSpan>]
[-MaxDeliveryCount <Int32>]
[-RequiresSession]
[-Status <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityNamespaceExpanded
New-AzServiceBusSubscription
-Name <String>
-TopicName <String>
-NamespaceInputObject <IServiceBusIdentity>
[-AutoDeleteOnIdle <TimeSpan>]
[-ClientId <String>]
[-DeadLetteringOnFilterEvaluationException]
[-DeadLetteringOnMessageExpiration]
[-DefaultMessageTimeToLive <TimeSpan>]
[-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
[-EnableBatchedOperations]
[-ForwardDeadLetteredMessagesTo <String>]
[-ForwardTo <String>]
[-IsClientAffine]
[-IsDurable]
[-IsShared]
[-LockDuration <TimeSpan>]
[-MaxDeliveryCount <Int32>]
[-RequiresSession]
[-Status <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityNamespace
New-AzServiceBusSubscription
-Name <String>
-TopicName <String>
-NamespaceInputObject <IServiceBusIdentity>
-Parameter <ISbSubscription>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityTopicExpanded
New-AzServiceBusSubscription
-Name <String>
-TopicInputObject <IServiceBusIdentity>
[-AutoDeleteOnIdle <TimeSpan>]
[-ClientId <String>]
[-DeadLetteringOnFilterEvaluationException]
[-DeadLetteringOnMessageExpiration]
[-DefaultMessageTimeToLive <TimeSpan>]
[-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
[-EnableBatchedOperations]
[-ForwardDeadLetteredMessagesTo <String>]
[-ForwardTo <String>]
[-IsClientAffine]
[-IsDurable]
[-IsShared]
[-LockDuration <TimeSpan>]
[-MaxDeliveryCount <Int32>]
[-RequiresSession]
[-Status <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityTopic
New-AzServiceBusSubscription
-Name <String>
-TopicInputObject <IServiceBusIdentity>
-Parameter <ISbSubscription>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
Crie uma assinatura de tópico.
Exemplos
Exemplo 1: Criar uma nova assinatura do ServiceBus
New-AzServiceBusSubscription -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -Name mySubscription -DefaultMessageTimeToLive (New-TimeSpan -Days 6) -EnableBatchedOperations
AccessedAt : 1/1/0001 12:00:00 AM
AutoDeleteOnIdle : 10675199.02:48:05.4775807
ClientId :
CountDetailActiveMessageCount : 0
CountDetailDeadLetterMessageCount : 0
CountDetailScheduledMessageCount : 0
CountDetailTransferDeadLetterMessageCount : 0
CountDetailTransferMessageCount : 0
CreatedAt : 9/23/2022 2:37:46 PM
DeadLetteringOnFilterEvaluationException : True
DeadLetteringOnMessageExpiration : False
DefaultMessageTimeToLive : 6.00:00:00
DuplicateDetectionHistoryTimeWindow :
EnableBatchedOperations : True
ForwardDeadLetteredMessagesTo :
ForwardTo :
Id : /subscriptions/326100e2-f69d-4268-8503-075374f62b6e/resourceGroups/damorg/providers/Microsoft.ServiceBus/namespaces/testlatests
bmsi/topics/a/subscriptions/testsub
IsClientAffine : False
IsDurable :
IsShared :
Location : westus
LockDuration : 00:01:00
MaxDeliveryCount : 10
MessageCount : 0
Name : testsub
RequiresSession : False
ResourceGroupName : damorg
Status : Active
Cria uma nova assinatura mySubscription do ServiceBus no tópico myTopic.
Parâmetros
-AutoDeleteOnIdle
Intervalo ocioso após o qual a fila é excluída automaticamente.
A duração mínima é de 5 minutos.
Propriedades dos parâmetros
Tipo: TimeSpan
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ClientId
Indica a ID do cliente do aplicativo que criou a assinatura de cliente afim.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeadLetteringOnFilterEvaluationException
Valor que indica se uma assinatura tem suporte a letra morta em exceções de avaliação de filtro.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DeadLetteringOnMessageExpiration
Valor que indica se uma assinatura tem suporte a letra morta quando uma mensagem expira.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DefaultMessageTimeToLive
Esta é a duração após a qual a mensagem expira, a partir de quando a mensagem é enviada para o Service Bus.
Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si.
Propriedades dos parâmetros
Tipo: TimeSpan
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DuplicateDetectionHistoryTimeWindow
Define a duração do histórico de deteção de duplicados.
O valor padrão é 10 minutos.
Propriedades dos parâmetros
Tipo: TimeSpan
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por 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 dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ForwardDeadLetteredMessagesTo
Nome da fila/tópico para encaminhar a mensagem de letra morta
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ForwardTo
Nome da fila/tópico para encaminhar as mensagens
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-IsClientAffine
Valor que indica se a assinatura tem afinidade com a ID do cliente.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-IsDurable
Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é durável ou não.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-IsShared
Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é compartilhada ou não.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-LockDuration
Duração do período de tempo de um peek-lock; ou seja, a quantidade de tempo que a mensagem está bloqueada para outros recetores.
O valor máximo para LockDuration é 5 minutos; O valor padrão é 1 minuto.
Propriedades dos parâmetros
Tipo: TimeSpan
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-MaxDeliveryCount
Número máximo de entregas.
Propriedades dos parâmetros
Tipo: Int32
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Name
O nome da assinatura.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Nome da Subscrição
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
Parâmetro de identidade
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespace
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-NamespaceName
O nome do namespace
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Parameter
Descrição do recurso de assinatura.
Propriedades dos parâmetros
Tipo: ISbSubscription
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateViaIdentityNamespace
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopic
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-RequiresSession
Valor que indica se uma subscrição suporta o conceito de sessões.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ResourceGroupName
Nome do grupo de Recursos dentro da assinatura do Azure.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Status
Enumera os valores possíveis para o status de uma entidade de mensagens.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-SubscriptionId
Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure.
O ID da assinatura faz parte do URI de cada chamada de serviço.
Propriedades dos parâmetros
Tipo: String
Valor padrão: (Get-AzContext).Subscription.Id
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
Parâmetro de identidade
CreateViaIdentityTopicExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityTopic
Posição: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-TopicName
O nome do tópico.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
CreateExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespaceExpanded
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CreateViaIdentityNamespace
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por 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 dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por 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