New-AzureSBAuthorizationRule
新しい Service Bus 承認規則を作成します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
New-AzureSBAuthorizationRule
-Name <String>
[-Permission <AccessRights[]>]
-Namespace <String>
-EntityName <String>
-EntityType <ServiceBusEntityType>
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
New-AzureSBAuthorizationRule
-Name <String>
[-Permission <AccessRights[]>]
-Namespace <String>
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
説明
New-AzureSBAuthorizationRule コマンドレットは、Service Bus 承認規則を作成します。
重要
Service Bus 用の Service Management REST API は、2021 年 11 月 1 日までに廃止されます。 API の 廃止に関する詳細については、Azure Service Manager の廃止に関するページを参照してください。 Service Bus 用のこの Azure Service Management PowerShell コマンドレットは、2021 年 11 月 1 日の時点でサポートされなくなります。 新しい Azure PowerShell コマンドレットに移行してください
例
例 1: 生成された主キーを使用して承認規則を作成する
PS C:\> New-AzureSBAuthorizationRule -Name MyRule -Namespace MyNamespace -Permission $("Send")
送信アクセス許可を持つ名前空間レベルで新しい承認規則を作成します。
例 2: 主キーを指定して承認規則を作成する
PS C:\> New-AzureSBAuthorizationRule -Name MyRule -Namespace MyNamespace -Permission $("Manage", "Listen", "Send") -EntityName MyEntity -EntityType Queue -PrimaryKey P+lL/Mnd2Z9sj5hwMrRyAxQDdX8RHfbdqU2eIAqs1rc=
すべてのアクセス許可を持つ MyEntity キュー レベルで新しい承認規則を作成します。
パラメーター
-EntityName
ルールを適用するエンティティ名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EntityType
エンティティ型を指定します。 有効な値は次のとおりです。
- キュー
- トピック
- リレー
- NotificationHub
型: | ServiceBusEntityType |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
一意の承認規則名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Namespace
承認規則を適用する名前空間名を指定します。 EntityName が指定されていない場合、ルールは名前空間レベルになります。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Permission
承認アクセス許可 (送信、管理、リッスン)。
型: | AccessRights[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PrimaryKey
Shared Access Signature の主キーを指定します。 指定されていない場合は生成されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SecondaryKey
Shared Access Signature セカンダリ キーを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |