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