你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzServiceBusRule

创建新规则并创建现有规则

语法

CreateExpanded (默认值)

New-AzServiceBusRule
    -Name <String>
    -NamespaceName <String>
    -ResourceGroupName <String>
    -SubscriptionName <String>
    -TopicName <String>
    [-SubscriptionId <String>]
    [-ActionRequiresPreprocessing]
    [-ActionSqlExpression <String>]
    [-ContentType <String>]
    [-CorrelationFilterProperty <Hashtable>]
    [-CorrelationFilterRequiresPreprocessing]
    [-CorrelationId <String>]
    [-FilterType <String>]
    [-Label <String>]
    [-MessageId <String>]
    [-ReplyTo <String>]
    [-ReplyToSessionId <String>]
    [-SessionId <String>]
    [-SqlExpression <String>]
    [-SqlFilterRequiresPreprocessing]
    [-To <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityTopicExpanded

New-AzServiceBusRule
    -Name <String>
    -SubscriptionName <String>
    -TopicInputObject <IServiceBusIdentity>
    [-ActionRequiresPreprocessing]
    [-ActionSqlExpression <String>]
    [-ContentType <String>]
    [-CorrelationFilterProperty <Hashtable>]
    [-CorrelationFilterRequiresPreprocessing]
    [-CorrelationId <String>]
    [-FilterType <String>]
    [-Label <String>]
    [-MessageId <String>]
    [-ReplyTo <String>]
    [-ReplyToSessionId <String>]
    [-SessionId <String>]
    [-SqlExpression <String>]
    [-SqlFilterRequiresPreprocessing]
    [-To <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityTopic

New-AzServiceBusRule
    -Name <String>
    -SubscriptionName <String>
    -TopicInputObject <IServiceBusIdentity>
    -Parameter <IRule>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespaceExpanded

New-AzServiceBusRule
    -Name <String>
    -SubscriptionName <String>
    -TopicName <String>
    -NamespaceInputObject <IServiceBusIdentity>
    [-ActionRequiresPreprocessing]
    [-ActionSqlExpression <String>]
    [-ContentType <String>]
    [-CorrelationFilterProperty <Hashtable>]
    [-CorrelationFilterRequiresPreprocessing]
    [-CorrelationId <String>]
    [-FilterType <String>]
    [-Label <String>]
    [-MessageId <String>]
    [-ReplyTo <String>]
    [-ReplyToSessionId <String>]
    [-SessionId <String>]
    [-SqlExpression <String>]
    [-SqlFilterRequiresPreprocessing]
    [-To <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityNamespace

New-AzServiceBusRule
    -Name <String>
    -SubscriptionName <String>
    -TopicName <String>
    -NamespaceInputObject <IServiceBusIdentity>
    -Parameter <IRule>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentitySubscriptionExpanded

New-AzServiceBusRule
    -Name <String>
    -SubscriptionInputObject <IServiceBusIdentity>
    [-ActionRequiresPreprocessing]
    [-ActionSqlExpression <String>]
    [-ContentType <String>]
    [-CorrelationFilterProperty <Hashtable>]
    [-CorrelationFilterRequiresPreprocessing]
    [-CorrelationId <String>]
    [-FilterType <String>]
    [-Label <String>]
    [-MessageId <String>]
    [-ReplyTo <String>]
    [-ReplyToSessionId <String>]
    [-SessionId <String>]
    [-SqlExpression <String>]
    [-SqlFilterRequiresPreprocessing]
    [-To <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentitySubscription

New-AzServiceBusRule
    -Name <String>
    -SubscriptionInputObject <IServiceBusIdentity>
    -Parameter <IRule>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

创建新规则并创建现有规则

示例

示例 1:创建关联筛选器

New-AzServiceBusRule -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -SubscriptionName mySubscription -Name myCorrelationRule -FilterType CorrelationFilter -ContentType contenttype -CorrelationFilterProperty @{a='b';c='d'} -SessionId sessionid -CorrelationId correlationid -MessageId messageid -Label label -ReplyTo replyto -ReplyToSessionId replytosessionid
ActionCompatibilityLevel               :
ActionRequiresPreprocessing            :
ActionSqlExpression                    :
ContentType                            : contenttype
CorrelationFilterProperty              : {
                                           "c": "d",
                                           "a": "b"
                                         }
CorrelationFilterRequiresPreprocessing :
CorrelationId                          : correlationid
FilterType                             : CorrelationFilter
Id                                     : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/topics/myTopic/subscriptions/mySubscription/rules/myCorrelationRule
Label                                  : label
Location                               : westus
MessageId                              : messageid
Name                                   : myCorrelationRule
ReplyTo                                : replyto
ReplyToSessionId                       : replytosessionid
ResourceGroupName                      : myResourceGroup
SessionId                              : sessionid
SqlExpression                          :
SqlFilterCompatibilityLevel            :

在 ServiceBus 订阅myCorrelationRule中创建关联筛选器mySubscription

示例 2:创建 Sql 筛选器

New-AzServiceBusRule -ResourceGroupName myResourceGroup -NamespaceName myNamespace -TopicName myTopic -SubscriptionName mySubscription -Name mySqlRule -FilterType SqlFilter -SqlExpression 3=2 -ActionSqlExpression "SET a=b"
ActionCompatibilityLevel               : 20
ActionRequiresPreprocessing            :
ActionSqlExpression                    : SET a=b
ContentType                            :
CorrelationFilterProperty              : {
                                         }
CorrelationFilterRequiresPreprocessing :
CorrelationId                          :
FilterType                             : SqlFilter
Id                                     : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.ServiceBus/namespaces/myNamespace/topics/myTopic/subscriptions/mySubscription/rules/mySqlRule
Label                                  :
Location                               : westus
MessageId                              :
Name                                   : mySqlRule
ReplyTo                                :
ReplyToSessionId                       :
ResourceGroupName                      : myResourceGroup
SessionId                              :
SqlExpression                          : 3=2
SqlFilterCompatibilityLevel            : 20
SqlFilterRequiresPreprocessing         :

在 ServiceBus 订阅mySqlRule中创建 sql 筛选器mySubscription

参数

-ActionRequiresPreprocessing

指示规则操作是否需要预处理的值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ActionSqlExpression

SQL 表达式。 例如 MyProperty='ABC'

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContentType

消息的内容类型。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CorrelationFilterProperty

自定义筛选器的字典对象

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CorrelationFilterRequiresPreprocessing

指示规则操作是否需要预处理的值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CorrelationId

关联标识符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FilterType

根据 BrokeredMessage 计算的筛选器类型。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Label

应用程序特定的标签。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MessageId

消息的标识符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

规则名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:规则名称

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NamespaceInputObject

标识参数

参数属性

类型:IServiceBusIdentity
默认值:None
支持通配符:False
不显示:False

参数集

CreateViaIdentityNamespaceExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespace
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NamespaceName

命名空间名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Parameter

规则资源的说明。

参数属性

类型:IRule
默认值:None
支持通配符:False
不显示:False

参数集

CreateViaIdentityTopic
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespace
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscription
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReplyTo

要答复的队列的地址。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReplyToSessionId

要答复的会话标识符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

Azure 订阅中的资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SessionId

会话标识符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SqlExpression

SQL 表达式。 例如 MyProperty='ABC'

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SqlFilterRequiresPreprocessing

指示规则操作是否需要预处理的值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionId

唯一标识Microsoft Azure 订阅的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionInputObject

标识参数

参数属性

类型:IServiceBusIdentity
默认值:None
支持通配符:False
不显示:False

参数集

CreateViaIdentitySubscriptionExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscription
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionName

订阅名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopic
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespace
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-To

要发送到的地址。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopicExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentitySubscriptionExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TopicInputObject

标识参数

参数属性

类型:IServiceBusIdentity
默认值:None
支持通配符:False
不显示:False

参数集

CreateViaIdentityTopicExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityTopic
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TopicName

主题名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespaceExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateViaIdentityNamespace
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

IRule

IServiceBusIdentity

输出

IRule