Set-AzNotificationHubAuthorizationRule

Módulo:
Az.NotificationHubs Module

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

Sintaxe

InputFileParameterSet 

Set-AzNotificationHubAuthorizationRule
    [-ResourceGroup] <String>
    [-Namespace] <String>
    [-NotificationHub] <String>
    [-InputFile] <String>
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SASRuleParameterSet 

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. Pode configurar o objeto através 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": "W******Y=", "Rights": [ "Listen", "Send" ] } 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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

Não peça confirmação.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputFile

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InputFileParameterSet
Position:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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, centros de notificação e regras de autorização de forma a facilitar a gestão de inventário e a administração do Azure.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SASRule

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

Propriedades dos parâmetros

Tipo:SharedAccessAuthorizationRuleAttributes
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SASRuleParameterSet
Position:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

SharedAccessAuthorizationRuleAttributes