Set-AzNotificationHubAuthorizationRule

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

Syntaxe

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

L’applet de commande Set-AzNotificationHubAuthorizationRule modifie une règle d’autorisation SAS (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 que la règle possède. Vous pouvez configurer l’objet via l’infrastructure .NET. Vous pouvez ensuite copier ces valeurs de propriété dans votre règle à l’aide du 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= », « Rights » : [ « Listen », « Send » ] } 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 d’accorder 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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Ne demandez pas de confirmation.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputFile

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

InputFileParameterSet
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 simplement la gestion des stocks et l’administration Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SASRule

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

Propriétés du paramètre

Type:SharedAccessAuthorizationRuleAttributes
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SASRuleParameterSet
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

SharedAccessAuthorizationRuleAttributes