共用方式為

New-AzNotificationHubsNamespaceAuthorizationRule

  • 參考
模組:
Az.NotificationHubs

建立授權規則，並將該規則指派給通知中樞命名空間。

語法

New-AzNotificationHubsNamespaceAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-InputFile] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzNotificationHubsNamespaceAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzNotificationHubsNamespaceAuthorizationRule Cmdlet 會建立共用存取簽章 （SAS） 授權規則，並將它指派給通知中樞命名空間。 授權規則會管理命名空間的用戶權力，以及該命名空間所包含的通知中樞。 此 Cmdlet 提供兩種方式來建立新的授權規則，並將它指派給命名空間。 您可以建立 SharedAccessAuthorizationRuleAttributes 對象的實例，然後使用您希望新規則擁有的屬性值來設定該物件。 這可以使用 .NET Framework 來完成。 然後，您可以使用 SASRule 參數將這些屬性值複製到新的規則。 或者，您可以建立包含相關組態值的 JSON（JavaScript 物件表示法）檔案，然後使用 InputFile 參數套用這些值。 JSON 檔案是使用類似下列語法的文本文件： {
“Name”： “ContosoAuthorizationRule”，
“PrimaryKey”： “WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=”，
“Rights”： [
“Listen”，
“Send”
]
} 搭配 New-AzNotificationHubsNamespaceAuthorizationRule Cmdlet 使用 時，上述 JSON 範例會建立名為 ContosoAuthorizationRule 的授權規則，為使用者提供命名空間的接聽和傳送許可權。 用於驗證的 PrimaryKey 可以使用下列 Windows PowerShell 命令隨機產生：[Convert]：：ToBase64String（1..32 |% { [byte/]（Get-Random -Minimum 0 -Maximum 255） }）

範例

範例 1：建立授權規則並將它指派給命名空間

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\NamespaceAuthorizationRules.json"

此命令會建立授權規則，並將該規則指派給命名空間 ContosoNamespace。 建立此規則時，您必須指定命名空間指派的適當命名空間和資源群組。 不過，您不需要指定規則本身的任何資訊：規則資訊會取自輸入檔 C：\Configuration\NamespaceAuthorizationRules.json。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputFile

指定 JSON 檔案的路徑，其中包含新授權規則的組態資訊。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Namespace

指定要指派授權規則的命名空間。 命名空間提供分組和分類通知中樞的方式。 新規則必須指派給現有的命名空間。 New-AzNotificationHubsNamespaceAuthorizationRule Cmdlet 無法建立新的命名空間。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ResourceGroup

指定指派命名空間的資源群組。 資源群組會以協助清查管理和 Azure 系統管理的方式，組織命名空間、通知中樞和授權規則等專案。 您必須使用現有的資源群組。 此 Cmdlet 無法建立新的資源群組。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-SASRule

指定 SharedAccessAuthorizationRuleAttributes 物件，其中包含新規則的組態資訊。

類型:SharedAccessAuthorizationRuleAttributes
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

輸出

SharedAccessAuthorizationRuleAttributes