Partager via

Set-AzNotificationHubAuthorizationRule

  • Référence
Module:
Az.NotificationHubs

Définit des règles d’autorisation pour un hub de notification.

Syntaxe

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

Description

La cmdlet Set-AzNotificationHubAuthorizationRule modifie une règle d’autorisation SAP (Shared Access Signature) affectée à un hub de notification. Les règles d’autorisation gèrent l’accès à vos hubs de notification en créant des liens, en tant qu’URI, en fonction de différents niveaux d’autorisation. Les niveaux d’autorisation peuvent être l’un des suivants :

  • Écouter
  • Envoyer
  • Gérer les clients est dirigé vers l’une de ces URI en fonction du niveau d’autorisation approprié. Par exemple, un client ayant donné l’autorisation d’écoute est dirigé vers l’URI de cette autorisation. Cette applet de commande fournit deux façons de modifier une règle d’autorisation affectée à un hub de notification. Pour un, vous pouvez créer une instance de l’objet SharedAccessAuthorizationRuleAttributes, puis configurer cet objet avec les valeurs de propriété que vous souhaitez posséder. Vous pouvez configurer l’objet via .NET Framework. Vous pouvez ensuite copier ces valeurs de propriété dans votre règle à l’aide de paramètre SASRule. Vous pouvez également créer un fichier JSON (JavaScript Object Notation) contenant les valeurs de configuration appropriées, puis appliquer ces valeurs via le paramètre InputFile. Un fichier JSON est un fichier texte qui utilise une syntaxe similaire à celle-ci : { « Name » : « ContosoAuthorizationRule »,
    « PrimaryKey » : « W******Y= »,
    « Droits » : [
    « Écouter »,
    « Envoyer »
    ]
    } Lorsqu’il est utilisé conjointement avec l’applet de commande New-AzNotificationHubAuthorizationRule, l’exemple JSON précédent modifie une règle d’autorisation nommée ContosoAuthorizationRule afin de donner aux utilisateurs des droits d’écoute et d’envoi au hub.

Exemples

Exemple 1 : Modifier une règle d’autorisation affectée à un hub de notification

Set-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationGroup" -NotificationHub "ContosoExternalHub" -InputFile "C:\Configuration\AuthorizationRules.json"

Cette commande modifie une règle d’autorisation affectée au hub de notification nommé ContosoExternalHub. Vous devez spécifier l’espace de noms où se trouve le hub ainsi que le groupe de ressources auquel le hub est affecté. Les informations sur la règle modifiée ne sont pas incluses dans la commande elle-même. Au lieu de cela, ces informations se trouvent dans le fichier d’entrée C:\Configuration\AuthorizationRules.jsactivé.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Ne demandez pas de confirmation.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputFile

Spécifie le chemin d’accès à un fichier JSON contenant des informations de configuration pour la nouvelle règle.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Namespace

Spécifie l’espace de noms auquel le hub de notification est affecté. Les espaces de noms permettent de regrouper et de classer les hubs de notification.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NotificationHub

Spécifie le hub de notification auquel cette applet de commande attribue des règles d’autorisation. Les hubs de notification sont utilisés pour envoyer des notifications Push à plusieurs clients, quel que soit l’utilisateur utilisé par ces clients.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroup

Spécifie le groupe de ressources auquel le hub de notification est affecté. Les groupes de ressources organisent des éléments tels que des espaces de noms, des hubs de notification et des règles d’autorisation de manière à faciliter la gestion des stocks et l’administration Azure.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SASRule

Spécifie l’objet SharedAccessAuthorizationRuleAttributes qui contient des informations de configuration pour les règles d’autorisation modifiées.

Type:SharedAccessAuthorizationRuleAttributes
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Sorties