共用方式為


New-AzNotificationHubsNamespaceAuthorizationRule

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

Syntax

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
Aliases:cf
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

類型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

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

類型:String
Position:2
預設值:None
必要:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

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

類型:String
Position:1
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroup

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

類型:String
Position:0
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

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

類型:SharedAccessAuthorizationRuleAttributes
Position:2
預設值:None
必要:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

類型:SwitchParameter
Aliases:wi
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

輸出

SharedAccessAuthorizationRuleAttributes