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

New-AzServiceBusRule

模块:

Az.ServiceBus

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

语法

New-AzServiceBusRule
   -Name <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -SubscriptionName <String>
   -TopicName <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>]

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>]

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

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>]

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

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>]

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 订阅mySubscription中创建关联筛选器myCorrelationRule。

示例 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 订阅mySubscription中创建 sql 筛选器mySqlRule。

参数

-ActionRequiresPreprocessing

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ActionSqlExpression

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ContentType

消息的内容类型。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CorrelationFilterProperty

自定义筛选器的字典对象

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CorrelationFilterRequiresPreprocessing

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CorrelationId

相关性标识符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FilterType

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Label

应用程序特定的标签。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MessageId

消息的标识符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

规则名称。

类型:	String
别名:	RuleName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NamespaceInputObject

标识参数

类型:	IServiceBusIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-NamespaceName

命名空间名称

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Parameter

规则资源的说明。

类型:	IRule
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ReplyTo

要回复的队列地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReplyToSessionId

要答复的会话标识符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SessionId

会话标识符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SqlExpression

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SqlFilterRequiresPreprocessing

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SubscriptionId

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

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-SubscriptionInputObject

标识参数

类型:	IServiceBusIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SubscriptionName

订阅名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-To

要发送到的地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TopicInputObject

标识参数

类型:	IServiceBusIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TopicName

主题名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

IRule

IServiceBusIdentity

输出

IRule