Partilhar via

New-AzNotificationHubsNamespaceAuthorizationRule

  • Referência
Módulo:
Az.NotificationHubs

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

Sintaxe

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

Description

O cmdlet New-AzNotificationHubsNamespaceAuthorizationRule cria uma regra de autorização SAS (Assinatura de Acesso Compartilhado) e a atribui a um namespace de hub de notificação. As regras de autorização gerenciam os direitos de usuário para o namespace e para os hubs de notificação contidos com esse namespace. Este cmdlet fornece duas maneiras de criar uma nova regra de autorização e atribuí-la a um namespace. Você pode criar uma instância do objeto SharedAccessAuthorizationRuleAttributes e configurar esse objeto com os valores de propriedade que você deseja que a nova regra possua. Isso pode ser feito usando o .NET Framework. Em seguida, você pode copiar esses valores de propriedade para sua nova 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 usando o parâmetro InputFile. Um arquivo JSON é um arquivo de texto que usa sintaxe semelhante à seguinte: {
"Nome": "ContosoAuthorizationRule",
"Chave primária": "W******1Y=",
"Direitos": [
"Ouvir",
"Enviar"
]
} Quando usado em conjunto com o cmdlet New-AzNotificationHubsNamespaceAuthorizationRule, o exemplo JSON anterior cria uma regra de autorização chamada ContosoAuthorizationRule que concede aos usuários direitos de Escuta e Envio para o namespace. O PrimaryKey usado para autenticação pode ser gerado aleatoriamente usando o seguinte comando do Windows PowerShell: [Convert]::ToBase64String((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Exemplos

Exemplo 1: Criar uma regra de autorização e atribuí-la a um namespace

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\NamespaceAuthorizationRules.json"

Este comando cria uma regra de autorização e atribui essa regra ao namespace ContosoNamespace. Ao criar essa regra, você deve especificar o namespace apropriado e o grupo de recursos ao qual o namespace está atribuído. No entanto, você não precisa especificar nenhuma informação sobre a regra em si: as informações da regra serão retiradas do arquivo de entrada C:\Configuration\NamespaceAuthorizationRules.jsem diante.

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

-InputFile

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

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

-Namespace

Especifica o namespace ao qual as regras de autorização serão atribuídas. Os namespaces fornecem uma maneira de agrupar e categorizar hubs de notificação. As novas regras devem ser atribuídas a um namespace existente. O cmdlet New-AzNotificationHubsNamespaceAuthorizationRule não pode criar um novo namespace.

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

-ResourceGroup

Especifica o grupo de recursos ao qual o namespace é 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. Você deve usar um grupo de recursos existente. Este cmdlet não pode criar um novo grupo de recursos.

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 novas regras.

Tipo:SharedAccessAuthorizationRuleAttributes
Position:2
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

Saídas