Set-AzNotificationHubAuthorizationRule
設定通知中樞的授權規則。
語法
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”: “W******Y=”,
“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.js中找到。
參數
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
請勿要求確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputFile
指定 JSON 檔案的路徑,其中包含新規則的組態資訊。
類型: | String |
Position: | 3 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Namespace
指定指派通知中樞的命名空間。 命名空間提供分組和分類通知中樞的方式。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-NotificationHub
指定此 Cmdlet 指派授權規則給的通知中樞。 通知中樞可用來將推播通知傳送給多個用戶端,而不論這些用戶端所使用的 。
類型: | String |
Position: | 2 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ResourceGroup
指定指派通知中樞的資源群組。 資源群組會以協助清查管理和 Azure 系統管理的方式,組織命名空間、通知中樞和授權規則等專案。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-SASRule
指定 SharedAccessAuthorizationRuleAttributes 物件,其中包含已修改之授權規則的組態資訊。
類型: | SharedAccessAuthorizationRuleAttributes |
Position: | 3 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
輸出
SharedAccessAuthorizationRuleAttributes