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 hubs de notificação pela 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 uma dessas URIs com base no nível de permissão apropriado. Por exemplo, um cliente com a permissão Listen será direcionado para o URI para essa permissão. Esse cmdlet fornece duas maneiras de modificar uma regra de autorização atribuída a um hub de notificação. Por exemplo, você pode criar uma instância do objeto SharedAccessAuthorizationRuleAttributes e configurar esse objeto com os valores de propriedade que 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 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 dar 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"

Esse comando modifica uma regra de autorização atribuída ao hub de notificação chamado ContosoExternalHub. Você deve especificar o namespace em que o hub está localizado, bem como o grupo de recursos atribuído ao hub. As informações sobre a regra modificada não estão incluídas no comando em si. Em vez disso, essas informações são encontradas no arquivo de entrada C:\Configuration\AuthorizationRules.js.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Não peça confirmação.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputFile

Especifica o caminho para um arquivo JSON que contém informações de configuração para a nova regra.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

InputFileParameterSet
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroup

Especifica o grupo de recursos ao qual o hub de notificação é 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 Azure administração.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SASRule

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

Propriedades do parâmetro

Tipo:SharedAccessAuthorizationRuleAttributes
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SASRuleParameterSet
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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