Share via

Set-AzNotificationHubAuthorizationRule

  • 參考
模組:
Az.NotificationHubs

設定通知中樞的授權規則。

Syntax

Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-InputFile] <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzNotificationHubAuthorizationRule Cmdlet 會修改指派給通知中樞的共用存取簽章 （SAS） 授權規則。 授權規則會根據不同的許可權等級，建立鏈接作為 URI 來管理通知中樞的存取權。 權限等級可以是下列其中一項：

  • 接聽
  • 傳送
  • 管理客戶端會根據適當的許可權等級，導向至下列其中一個 URI。 例如，指定 Listen 許可權的用戶端會導向至該許可權的 URI。 此 Cmdlet 提供兩種方式來修改指派給通知中樞的授權規則。 針對其中一個，您可以建立 SharedAccessAuthorizationRuleAttributes 對象的實例，然後使用您希望規則擁有的屬性值來設定該物件。 您可以透過 .NET Framework 設定 物件。 然後，您可以使用 SASRule 參數將這些屬性值複製到規則。 或者，您可以建立包含相關組態值的 JSON（JavaScript 物件表示法）檔案，然後透過 InputFile 參數套用這些值。 JSON 檔案是使用類似下列語法的文本檔： { “Name”： “ContosoAuthorizationRule”，
    “PrimaryKey”： “WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=”，
    “Rights”： [
    “Listen”，
    “Send”
    ]
    } 搭配 New-AzNotificationHubAuthorizationRule Cmdlet 使用時，上述 JSON 範例會修改名為 ContosoAuthorizationRule 的授權規則，讓用戶能夠接聽和傳送中樞的許可權。

範例

範例 1：修改指派給通知中樞的授權規則

Set-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationGroup" -NotificationHub "ContosoExternalHub" -InputFile "C:\Configuration\AuthorizationRules.json"

此命令會修改指派給名為 ContosoExternalHub 之通知中樞的授權規則。 您必須指定中樞所在的命名空間，以及指派中樞的資源群組。 修改之規則的相關信息不會包含在命令本身中。 相反地，該資訊會在輸入檔 C：\Configuration\AuthorizationRules.json中找到。

參數

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

請勿要求確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

指定指派通知中樞的命名空間。 命名空間提供分組和分類通知中樞的方式。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NotificationHub

指定此 Cmdlet 指派授權規則給的通知中樞。 通知中樞可用來將推播通知傳送給多個用戶端，而不論這些用戶端所使用的 。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroup

指定指派通知中樞的資源群組。 資源群組會以協助清查管理和 Azure 系統管理的方式，組織命名空間、通知中樞和授權規則等專案。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

指定 SharedAccessAuthorizationRuleAttributes 物件，其中包含已修改之授權規則的組態資訊。

Type:SharedAccessAuthorizationRuleAttributes
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

輸出

SharedAccessAuthorizationRuleAttributes