Partilhar via

Set-AzNotificationHubAuthorizationRule

  • Referência
Módulo:
Az.NotificationHubs

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

Sintaxe

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:

  • Ouvir
  • 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 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",
    "Chave primária": "W******Y=",
    "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.jsem.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Não peça confirmação.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputFile

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

Tipo:String
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SASRule

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

Tipo:SharedAccessAuthorizationRuleAttributes
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

SharedAccessAuthorizationRuleAttributes