Partager via

New-AzNotificationHubsNamespaceAuthorizationRule

  • Référence
Module:
Az.NotificationHubs

Crée une règle d’autorisation et attribue cette règle à un espace de noms du hub de notification.

Syntaxe

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

La cmdlet New-AzNotificationHubsNamespaceAuthorizationRule crée une règle d’autorisation SAS (Shared Access Signature) et l’affecte à un espace de noms du hub de notification. Les règles d’autorisation gèrent les droits utilisateur sur l’espace de noms et les hubs de notification contenus dans cet espace de noms. Cette applet de commande fournit deux façons de créer une règle d’autorisation et de l’affecter à un espace de noms. 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 nouvelle règle possède. Cette opération peut être effectuée à l’aide de .NET Framework. Vous pouvez ensuite copier ces valeurs de propriété dans votre nouvelle 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 à l’aide du paramètre InputFile. Un fichier JSON est un fichier texte qui utilise une syntaxe similaire à ce qui suit : {
« Name » : « ContosoAuthorizationRule »,
« PrimaryKey » : « W******1Y= »,
« Droits » : [
« Écouter »,
« Envoyer »
]
} Lorsqu’il est utilisé conjointement avec l’applet de commande New-AzNotificationHubsNamespaceAuthorizationRule, l’exemple JSON précédent crée une règle d’autorisation nommée ContosoAuthorizationRule qui permet aux utilisateurs d’écouter et d’envoyer des droits à l’espace de noms. Le PrimaryKey utilisé pour l’authentification peut être généré de manière aléatoire à l’aide de la commande Windows PowerShell suivante : [Convert] ::ToBase64String((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Exemples

Exemple 1 : Créer une règle d’autorisation et l’affecter à un espace de noms

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\NamespaceAuthorizationRules.json"

Cette commande crée une règle d’autorisation et affecte cette règle à l’espace de noms ContosoNamespace. Lors de la création de cette règle, vous devez spécifier l’espace de noms approprié et le groupe de ressources auquel l’espace de noms est affecté. Toutefois, vous n’avez pas besoin de spécifier d’informations sur la règle elle-même : les informations de règle sont extraites du fichier d’entrée C:\Configuration\NamespaceAuthorizationRules.jssur.

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

-InputFile

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

Type:String
Position:2
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 les règles d’autorisation seront affectées. Les espaces de noms permettent de regrouper et de classer les hubs de notification. Les nouvelles règles doivent être affectées à un espace de noms existant. L’applet de commande New-AzNotificationHubsNamespaceAuthorizationRule ne peut pas créer d’espace de noms.

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

-ResourceGroup

Spécifie le groupe de ressources auquel l’espace de noms 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. Vous devez utiliser un groupe de ressources existant. Cette applet de commande ne peut pas créer un groupe de ressources.

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 contenant des informations de configuration pour les nouvelles règles.

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

String

Sorties

SharedAccessAuthorizationRuleAttributes