Compartilhar via

New-AzNotificationHubAuthorizationRule

  • Referência
Módulo:
Az.NotificationHubs

Cria uma regra de autorização e atribui a regra a um hub de notificação.

Sintaxe

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

Description

O cmdlet New-AzNotificationHubAuthorizationRule cria uma regra de autorização SAS (Assinatura de Acesso Compartilhado) do hub de notificação. As regras de autorização são usadas para gerenciar o acesso aos hubs de notificação. Isso é feito pela criação de links, como URIs, com base em diferentes níveis de permissão. Os clientes são direcionados para um desses URIs com base no nível de permissão apropriado. Por exemplo, um cliente com a permissão Listen será direcionado para o URI dessa permissão.

Exemplos

Exemplo 1: Criar uma regra de autorização do hub de notificação

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -NotificationHub "ContosoInternalHub" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\ExternalAccessRule.json"

Esse comando cria uma nova regra de autorização e a atribui ao hub de notificação chamado ContosoInternalHub. Esse hub está localizado no namespace ContosoNamespace e é atribuído ao grupo de recursos ContosoNotificationsGroup. Observe que todas as informações de configuração da regra, incluindo o nome da regra, serão obtidas do arquivo de entrada C:\Configuration\ExternalAccessRule.json.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputFile

Especifica o arquivo de entrada para a regra de autorização que esse cmdlet cria.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Namespace

Especifica o namespace ao qual as regras de autorização são atribuídas. Os namespaces fornecem uma maneira de agrupar e categorizar hubs de notificação.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NotificationHub

Especifica o hub de notificação ao qual as regras de autorização serão atribuídas. Os hubs de notificação são usados para enviar notificações por push para vários clientes, independentemente da plataforma usada por esses clientes. Observe que você deve especificar o nome de um hub de notificação existente. O cmdlet New-AzNotificationHubAuthorizationRule não pode criar novos hubs de notificação.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroup

Especifica o grupo de recursos ao qual o hub de notificação está atribuído.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SASRule

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

Tipo:SharedAccessAuthorizationRuleAttributes
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

SharedAccessAuthorizationRuleAttributes