New-AzServiceBusSubscription
cree una suscripción de tema.
Sintaxis
CreateExpanded (valor predeterminado)
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>]
Description
cree una suscripción de tema.
Ejemplos
Ejemplo 1: Creación de una nueva suscripción a 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
Crea una nueva suscripción mySubscription de ServiceBus en el tema myTopic.
Parámetros
-AutoDeleteOnIdle
Intervalo de inactividad después del cual se elimina automáticamente la cola.
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
-ClientId
Indica el identificador de cliente de la aplicación que creó la suscripción de cliente affine.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
Esta es la duración después de la cual expira el mensaje, a partir de 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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
El parámetro DefaultProfile no es funcional.
Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.
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
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
-IsClientAffine
Valor que indica si la suscripción tiene una afinidad con el identificador de cliente.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
-IsDurable
En el caso de las suscripciones de cliente affine, este valor indica si la suscripción es duradera o no.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
-IsShared
En el caso de las suscripciones de cliente affine, este valor indica si la suscripción se comparte o no.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
-LockDuration
Duración del intervalo de tiempo 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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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 de entregas máximas.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
(All)
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
Parámetro de identidad
Tipo: IServiceBusIdentity
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityNamespace
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
-NamespaceName
Nombre del espacio de nombres
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
-Parameter
Descripción del recurso de suscripción.
Propiedades de parámetro
Tipo: ISbSubscription
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateViaIdentityNamespace
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
CreateViaIdentityTopic
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
-RequiresSession
Valor que indica si una suscripción admite el concepto de sesiones.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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 dentro de la suscripción de Azure.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityTopicExpanded
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
Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure.
El identificador de suscripción forma parte del URI de cada llamada de servicio.
Propiedades de parámetro
Tipo: String
Valor predeterminado: (Get-AzContext).Subscription.Id
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
Tipo: IServiceBusIdentity
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
CreateViaIdentityTopicExpanded
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
CreateViaIdentityTopic
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
-TopicName
Nombre del tema.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
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
CreateViaIdentityNamespaceExpanded
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
CreateViaIdentityNamespace
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