Set-AzServiceBusSubscription
Actualiza una suscripción de ServiceBus
Sintaxis
SetExpanded (valor predeterminado)
Set-AzServiceBusSubscription
-Name <String>
-TopicName <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-AutoDeleteOnIdle <TimeSpan>]
[-DefaultMessageTimeToLive <TimeSpan>]
[-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
[-LockDuration <TimeSpan>]
[-EnableBatchedOperations]
[-Status <String>]
[-ForwardTo <String>]
[-ForwardDeadLetteredMessagesTo <String>]
[-MaxDeliveryCount <Int32>]
[-DeadLetteringOnFilterEvaluationException]
[-DeadLetteringOnMessageExpiration]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SetViaIdentityExpanded
Set-AzServiceBusSubscription
-InputObject <IServiceBusIdentity>
[-AutoDeleteOnIdle <TimeSpan>]
[-DefaultMessageTimeToLive <TimeSpan>]
[-DuplicateDetectionHistoryTimeWindow <TimeSpan>]
[-LockDuration <TimeSpan>]
[-EnableBatchedOperations]
[-Status <String>]
[-ForwardTo <String>]
[-ForwardDeadLetteredMessagesTo <String>]
[-MaxDeliveryCount <Int32>]
[-DeadLetteringOnFilterEvaluationException]
[-DeadLetteringOnMessageExpiration]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Actualiza una suscripción de ServiceBus
Ejemplos
Ejemplo 1: Actualización de una suscripción de 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
Actualiza y suscripción a ServiceBus en el tema .
$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
Actualiza y suscripción de ServiceBus en el tema mediante el conjunto de parámetros InputObject.
Parámetros
-AsJob
Ejecución del comando como trabajo
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-AutoDeleteOnIdle
Intervalo de inactividad de intervalo de inactividad iso 8061 después del cual se elimina automáticamente la suscripción.
La duración mínima es de 5 minutos.
Propiedades de parámetro
Tipo: TimeSpan
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: cf
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DeadLetteringOnFilterEvaluationException
Valor que indica si una suscripción tiene compatibilidad con mensajes fallidos en las excepciones de evaluación de filtros.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DeadLetteringOnMessageExpiration
Valor que indica si una suscripción tiene compatibilidad con mensajes fallidos cuando expira un mensaje.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DefaultMessageTimeToLive
El intervalo de tiempo predeterminado del mensaje ISO 8601 es activo.
Esta es la duración después de la cual expira el mensaje, comenzando desde 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í.
Propiedades de parámetro
Tipo: TimeSpan
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
Tipo: PSObject
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: AzureRMContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DuplicateDetectionHistoryTimeWindow
Estructura timeSpan iso 8601 que define la duración del historial de detección de duplicados.
El valor predeterminado es 10 minutos.
Propiedades de parámetro
Tipo: TimeSpan
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-EnableBatchedOperations
Valor que indica si las operaciones por lotes del lado servidor están habilitadas.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ForwardDeadLetteredMessagesTo
Nombre de la cola o tema para reenviar el mensaje de mensajes fallidos
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ForwardTo
Nombre de cola o tema para reenviar los mensajes
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
Parámetro de identidad.
Para construir, vea la sección NOTES para las propiedades INPUTOBJECT y crear una tabla hash.
Tipo: IServiceBusIdentity
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
SetViaIdentityExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: True
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-LockDuration
Duración del intervalo de tiempo ISO 8601 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.
Propiedades de parámetro
Tipo: TimeSpan
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Name
Nombre de la suscripción.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: NombreDeSuscripción
Conjuntos de parámetros
SetExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-NamespaceName
Nombre del espacio de nombres serviceBus
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
SetExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-NoWait
Ejecutar el comando de forma asincrónica
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ResourceGroupName
Nombre del grupo de recursos.
El nombre distingue mayúsculas de minúsculas.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
SetExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Status
Enumera los valores posibles para el estado de una entidad de mensajería.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-SubscriptionId
Identificador de la suscripción de destino.
Propiedades de parámetro
Tipo: String
Valor predeterminado: (Get-AzContext).Subscription.Id
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
SetExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-TopicName
Nombre del tema.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
SetExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta.
El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: wi
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Salidas