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>]
Описание
Командлет Set-AzNotificationHubAuthorizationRule изменяет правило авторизации подписанного URL-адреса (SAS), назначенное концентратору уведомлений. Правила авторизации управляют доступом к центрам уведомлений путем создания ссылок в качестве URI на основе различных уровней разрешений. Уровни разрешений могут быть одним из следующих:
- Слушать
- Отправить
- Управление клиентами направляется на один из этих URI на основе соответствующего уровня разрешений.
Например, клиент, предоставленный разрешением прослушивания, будет направлен в URI для этого разрешения.
Этот командлет предоставляет два способа изменения правила авторизации, назначенного центру уведомлений.
Для одной из них можно создать экземпляр объекта SharedAccessAuthorizationRuleAttributes, а затем настроить этот объект со значениями свойств, которыми требуется обладать правилом.
Объект можно настроить с помощью .NET Framework.
Затем эти значения свойств можно скопировать в правило с помощью параметра SASRule.
Кроме того, можно создать файл JSON (нотация объектов JavaScript), содержащий соответствующие значения конфигурации, а затем применить эти значения с помощью параметра InputFile.
JSON-файл — это текстовый файл, который использует синтаксис, аналогичный этому: { Name: ContosoAuthorizationRule,
PrimaryKey: "W******Y=",
"Rights": [
"Прослушивать",
"Отправить"
]
} При использовании в сочетании с командлетом New-AzNotificationHubAuthorizationRule предыдущий пример JSON изменяет правило авторизации contosoAuthorizationRule для предоставления пользователям прав прослушивания и отправки в концентратор.
Примеры
Пример 1. Изменение правила авторизации, назначенного центру уведомлений
Set-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationGroup" -NotificationHub "ContosoExternalHub" -InputFile "C:\Configuration\AuthorizationRules.json"
Эта команда изменяет правило авторизации, назначенное концентратору уведомлений ContosoExternalHub. Необходимо указать пространство имен, в котором находится концентратор, а также группу ресурсов, назначенную концентратору. Сведения об измененном правиле не включаются в саму команду. Вместо этого эти сведения находятся в входном файле C:\Configuration\AuthorizationRules.js.
Параметры
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Force
Не запрашивайте подтверждение.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputFile
Указывает путь к JSON-файлу, содержащий сведения о конфигурации для нового правила.
Тип: | String |
Position: | 3 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Namespace
Указывает пространство имен, которому назначен концентратор уведомлений. Пространства имен позволяют группировать и классифицировать центры уведомлений.
Тип: | String |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-NotificationHub
Указывает центр уведомлений, которому этот командлет назначает правила авторизации. Центры уведомлений используются для отправки push-уведомлений нескольким клиентам независимо от используемого этими клиентами.
Тип: | String |
Position: | 2 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ResourceGroup
Указывает группу ресурсов, которой назначается концентратор уведомлений. Группы ресурсов упорядочивают такие элементы, как пространства имен, центры уведомлений и правила авторизации, которые помогают просто управлять инвентаризацией и администрированием Azure.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SASRule
Указывает объект SharedAccessAuthorizationRuleAttributes, содержащий сведения о конфигурации для измененных правил авторизации.
Тип: | SharedAccessAuthorizationRuleAttributes |
Position: | 3 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
SharedAccessAuthorizationRuleAttributes
Связанные ссылки
Azure PowerShell