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.

Syntax

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, em seguida, configurar esse objeto com os valores de propriedade que 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 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 usando o parâmetro InputFile . Um arquivo JSON é um arquivo de texto que usa sintaxe semelhante à seguinte: {
"Nome": "ContosoAuthorizationRule",
"PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
"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. A PrimaryKey usada para autenticação pode ser gerada 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.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

-InputFile

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

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