New-SBNamespace

New-SBNamespace

此 cmdlet 将在 Service Bus for Windows Server 场中创建一个新的 Service Bus for Windows Server 服务命名空间条目。

语法

Parameter Set: Default
New-SBNamespace -ManageUsers <String[]> -Name <String> [-AddressingScheme <NamespaceFormat> ] [-DnsEntry <String> ] [-IssuerName <String> ] [-IssuerUri <String> ] [-PrimarySymmetricKey <String> ] [-SecondarySymmetricKey <String> ] [-SubscriptionId <Guid> ] [ <CommonParameters>]

详细说明

运行 New-SBNamespace 可创建新的 Service Bus for Windows Server 服务命名空间。

Service Bus for Windows Server 服务命名空间的行为与 Service Bus for Windows Server 队列和主题的作用域实体类似,在多个应用程序(租户)之间提供隔离。创建Service Bus for Windows Server 实体(队列或主题)时,需要 Service Bus for Windows Server 服务命名空间名称。它为所有实体设置寻址架构以及 URI 前缀。

Service Bus for Windows Server 服务命名空间会遵循以下寻址架构之一:

1. 基于路径的服务命名空间(默认值)使用 Service Bus for Windows Server 主机 FQDN 作为服务命名空间名称的前缀。

2. 带服务 ID 的路径用于共享端口。此寻址架构既需必需的参数,也需 ServiceId 参数。

3. 向命名机构(例如 DNS)注册服务命名空间时使用 DNSRegistered 服务命名空间。对于此寻址架构,不但需要必需的参数,还需要 URI。

IssuerName、IssuerUri、PrimarySymmetricKey 和 SecondarySymmetricKey 都是可选的。

参数

-AddressingScheme<NamespaceFormat>

指定服务命名空间中使用的寻址架构。此属性的可能值为 Path (默认值)和 DNSRegistered. 如果指定值DNSRegistered ,则-DnsEntry 参数为必需参数。

别名

scheme

是否必需?

false

在哪里?

named

默认值

NamespaceFormat.Path

是否接受管道输入?

True (ByPropertyName)

是否接受通配符?

false

-DnsEntry<String>

指定 DNS 条目。

别名

是否必需?

false

在哪里?

named

默认值

是否接受管道输入?

True (ByPropertyName)

是否接受通配符?

false

-IssuerName<String>

指定受信任安全颁发机构的名称。

别名

是否必需?

false

在哪里?

named

默认值

是否接受管道输入?

True (ByValue, ByPropertyName)

是否接受通配符?

false

-IssuerUri<String>

指定区分大小写的颁发机构 URI。

别名

是否必需?

false

在哪里?

named

默认值

是否接受管道输入?

True (ByPropertyName)

是否接受通配符?

false

-ManageUsers<String[]>

指定将作为服务命名空间管理人员的用户或组的名称。

别名

manage

是否必需?

true

在哪里?

named

默认值

是否接受管道输入?

True (ByPropertyName)

是否接受通配符?

false

-Name<String>

指定新的 Service Bus for Windows Server 服务命名空间的名称。

别名

n

是否必需?

true

在哪里?

named

默认值

是否接受管道输入?

True (ByValue, ByPropertyName)

是否接受通配符?

false

-PrimarySymmetricKey<String>

指定要在此服务命名空间中使用的主关键字。

别名

primary

是否必需?

false

在哪里?

named

默认值

是否接受管道输入?

True (ByPropertyName)

是否接受通配符?

false

-SecondarySymmetricKey<String>

指定要在此服务命名空间中使用的辅助关键字。

别名

secondary

是否必需?

false

在哪里?

named

默认值

是否接受管道输入?

True (ByPropertyName)

是否接受通配符?

false

-SubscriptionId<Guid>

将命名空间与订阅相关联的可选参数。例如,如果管理员代表用户创建命名空间,则此参数会很有用。

别名

是否必需?

false

在哪里?

named

默认值

是否接受管道输入?

True (ByValue, ByPropertyName)

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持常见的参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 TechNet 上的 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

输入

输入类型是可以传送到 cmdlet 的对象的类型。

输出

输出类型是 cmdlet 发出的对象的类型。

示例

示例 1

创建名为 MyNamespace1 的 Service Bus for Windows Server 服务命名空间,并将 user1 指定为其所有者。

PS C:\> New-SBNamespace -Name MyNamespace1 -ManageUsers user1@domain1