Set-AzNotificationHubAuthorizationRule

  • Referência
Módulo:
Az.NotificationHubs

Define regras de autorização para um hub de notificação.

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

O cmdlet Set-AzNotificationHubAuthorizationRule modifica uma regra de autorização SAS (Assinatura de Acesso Compartilhado) atribuída a um hub de notificação. As regras de autorização gerenciam o acesso aos seus hubs de notificação através da criação de links, como URIs, com base em diferentes níveis de permissão. Os níveis de permissão podem ser um dos seguintes:

  • Escutar
  • Enviar
  • Gerenciar clientes é direcionado para um desses URIs com base no nível de permissão apropriado. Por exemplo, um cliente que recebe a permissão Ouvir será direcionado para o URI dessa permissão. Este cmdlet fornece duas maneiras de modificar uma regra de autorização atribuída a um hub de notificação. Por um lado, você pode criar uma instância do objeto SharedAccessAuthorizationRuleAttributes e, em seguida, configurar esse objeto com os valores de propriedade que você deseja que a regra possua. Você pode configurar o objeto por meio do .NET Framework. Em seguida, você pode copiar esses valores de propriedade para sua regra usando o parâmetro SASRule . Como alternativa, você pode criar um arquivo JSON (JavaScript Object Notation) contendo os valores de configuração relevantes e, em seguida, aplicar esses valores por meio do parâmetro InputFile . Um arquivo JSON é um arquivo de texto que usa sintaxe semelhante a esta: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
    "Direitos": [
    "Ouvir",
    "Enviar"
    ]
    } Quando usado em conjunto com o cmdlet New-AzNotificationHubAuthorizationRule, o exemplo JSON anterior modifica uma regra de autorização chamada ContosoAuthorizationRule para conceder aos usuários direitos de Escuta e Envio para o hub.

Exemplos

Exemplo 1: Modificar uma regra de autorização atribuída a um hub de notificação

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

Este comando modifica uma regra de autorização atribuída ao hub de notificação chamado ContosoExternalHub. Você deve especificar o namespace onde o hub está localizado, bem como o grupo de recursos ao qual o hub está atribuído. As informações sobre a regra modificada não são incluídas no próprio comando. Em vez disso, essas informações são encontradas no arquivo de entrada C:\Configuration\AuthorizationRules.json.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

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

-Force

Não peça confirmação.

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

-InputFile

Especifica o caminho para um arquivo JSON contendo informações de configuração para a nova regra.

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

-Namespace

Especifica o namespace ao qual o hub de notificação é atribuído. Os namespaces fornecem uma maneira de agrupar e categorizar hubs de notificação.

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

-NotificationHub

Especifica o hub de notificação ao qual esse cmdlet atribui regras de autorização. Os hubs de notificação são usados para enviar notificações por push para vários clientes, independentemente do usado por esses clientes.

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

-ResourceGroup

Especifica o grupo de recursos ao qual o hub de notificação está atribuído. Os grupos de recursos organizam itens como namespaces, hubs de notificação e regras de autorização de maneiras que ajudam simplesmente o gerenciamento de inventário e a administração do Azure.

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

-SASRule

Especifica o objeto SharedAccessAuthorizationRuleAttributes que contém informações de configuração para as regras de autorização que são modificadas.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

String

Saídas

SharedAccessAuthorizationRuleAttributes