Set-AzServiceBusSubscription

Referência

Módulo:: Az.ServiceBus

Atualiza uma assinatura do ServiceBus

Syntax

Set-AzServiceBusSubscription
   -Name <String>
   -TopicName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-AutoDeleteOnIdle <TimeSpan>]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-LockDuration <TimeSpan>]
   [-EnableBatchedOperations]
   [-Status <EntityStatus>]
   [-ForwardTo <String>]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-MaxDeliveryCount <Int32>]
   [-DeadLetteringOnFilterEvaluationException]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzServiceBusSubscription
   -InputObject <IServiceBusIdentity>
   [-AutoDeleteOnIdle <TimeSpan>]
   [-DefaultMessageTimeToLive <TimeSpan>]
   [-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
   [-LockDuration <TimeSpan>]
   [-EnableBatchedOperations]
   [-Status <EntityStatus>]
   [-ForwardTo <String>]
   [-ForwardDeadLetteredMessagesTo <String>]
   [-MaxDeliveryCount <Int32>]
   [-DeadLetteringOnFilterEvaluationException]
   [-DeadLetteringOnMessageExpiration]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Atualiza uma assinatura do ServiceBus

Exemplos

Exemplo 1: Atualizar uma assinatura do ServiceBus

Set-AzServiceBusSubscription -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -Name mySubscription -DefaultMessageTimeToLive (New-TimeSpan -Days 10) -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                  : 10.00:00:00
DuplicateDetectionHistoryTimeWindow       :
EnableBatchedOperations                   : True
ForwardDeadLetteredMessagesTo             :
ForwardTo                                 :
Id                                        : /subscriptions/000000000000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/topics/myTopic/subscriptions/mySubscription
IsClientAffine                            : False
IsDurable                                 :
IsShared                                  :
Location                                  : westus
LockDuration                              : 00:01:00
MaxDeliveryCount                          : 10
MessageCount                              : 0
Name                                      : testsub
RequiresSession                           : False
ResourceGroupName                         : myResourceGroup
Status                                    : Active

Atualizações DefaultMessageTimeToLive e EnableBatchedOperations assinatura mySubscription do ServiceBus no tópico myTopic.

Exemplo 1: Atualizar uma assinatura do ServiceBus usando o conjunto de parâmetros InputObject

$subscription = Get-AzServiceBusSubscription -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -Name mySubscription
Set-AzServiceBusSubscription -InputObject $subscription -DefaultMessageTimeToLive (New-TimeSpan -Days 10) -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                  : 10.00:00:00
DuplicateDetectionHistoryTimeWindow       :
EnableBatchedOperations                   : True
ForwardDeadLetteredMessagesTo             :
ForwardTo                                 :
Id                                        : /subscriptions/000000000000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/topics/myTopic/subscriptions/mySubscription
IsClientAffine                            : False
IsDurable                                 :
IsShared                                  :
Location                                  : westus
LockDuration                              : 00:01:00
MaxDeliveryCount                          : 10
MessageCount                              : 0
Name                                      : testsub
RequiresSession                           : False
ResourceGroupName                         : myResourceGroup
Status                                    : Active

Atualizações DefaultMessageTimeToLive e EnableBatchedOperations assinatura mySubscription do ServiceBus no tópico myTopic usando o conjunto de parâmetros InputObject.

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoDeleteOnIdle

Intervalo ocioso de timeSpan ISO 8061 após o qual a assinatura é excluída automaticamente. A duração mínima é de 5 minutos.

Tipo:	TimeSpan
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadLetteringOnFilterEvaluationException

Valor que indica se uma assinatura tem suporte a letras mortas em exceções de avaliação de filtro.

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadLetteringOnMessageExpiration

Valor que indica se uma assinatura tem suporte a letra morta quando uma mensagem expira.

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultMessageTimeToLive

Intervalo de tempo da mensagem padrão ISO 8601 para o valor em tempo real. 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.

Tipo:	TimeSpan
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DuplicateDetectionHistoryTimeWindow

Estrutura de timeSpan ISO 8601 que define a duração do histórico de detecção de duplicatas. O valor padrão é 10 minutos.

Tipo:	TimeSpan
Position:	Named
valor padrão:	None
Obrigatório:	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.

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForwardDeadLetteredMessagesTo

Nome da fila/tópico para encaminhar a mensagem de letra morta

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForwardTo

Nome da fila/tópico para encaminhar as mensagens

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Parâmetro de identidade. Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:	IServiceBusIdentity
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LockDuration

Duração do período de tempo ISO 8601 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.

Tipo:	TimeSpan
Position:	Named
valor padrão:	None
Obrigatório:	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.

Tipo:	Int32
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

O nome da Assinatura.

Tipo:	String
Aliases:	SubscriptionName
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NamespaceName

O nome do namespace ServiceBus

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Execute o comando de forma assíncrona

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Status

Enumera os valores possíveis para o status de uma entidade de mensagens.

Tipo:	EntityStatus
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

A ID da assinatura de destino.

Tipo:	String
Position:	Named
valor padrão:	(Get-AzContext).Subscription.Id
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TopicName

O nome do tópico.

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

IServiceBusIdentity

Saídas

ISbSubscription

Compartilhar via