Delen via

New-AzNotificationHubsNamespaceAuthorizationRule

  • Referentie
Module:
Az.NotificationHubs

Hiermee maakt u een autorisatieregel en wijst u die regel toe aan een Notification Hub-naamruimte.

Syntax

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

De cmdlet New-AzNotificationHubsNamespaceAuthorizationRule maakt een SAS-autorisatieregel (Shared Access Signature) en wijst deze toe aan een notification hub-naamruimte. Autorisatieregels beheren gebruikersrechten voor de naamruimte en de Notification Hubs die zijn opgenomen in die naamruimte. Deze cmdlet biedt twee manieren om een nieuwe autorisatieregel te maken en deze toe te wijzen aan een naamruimte. U kunt een exemplaar van het object SharedAccessAuthorizationRuleAttributes maken en dat object vervolgens configureren met de eigenschapswaarden waarvan u de nieuwe regel wilt bezitten. Dit kan worden gedaan met behulp van .NET Framework. U kunt deze eigenschapswaarden vervolgens naar uw nieuwe regel kopiëren met behulp van de SASRule-parameter . U kunt ook een JSON-bestand (JavaScript Object Notation) maken met de relevante configuratiewaarden en deze waarden vervolgens toepassen met behulp van de parameter InputFile . Een JSON-bestand is een tekstbestand dat gebruikmaakt van syntaxis die vergelijkbaar is met het volgende: {
"Naam": "ContosoAuthorizationRule",
"PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
"Rechten": [
"Luister",
"Verzenden"
]
} Wanneer het wordt gebruikt in combinatie met de cmdlet New-AzNotificationHubsNamespaceAuthorizationRule, maakt het voorgaande JSON-voorbeeld een autorisatieregel met de naam ContosoAuthorizationRule waarmee gebruikers de rechten voor luisteren en verzenden naar de naamruimte krijgen. De PrimaryKey die wordt gebruikt voor verificatie, kan willekeurig worden gegenereerd met behulp van de volgende Windows PowerShell-opdracht: [Converteren]::ToBase64String(((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Voorbeelden

Voorbeeld 1: Een autorisatieregel maken en deze toewijzen aan een naamruimte

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

Met deze opdracht maakt u een autorisatieregel en wijst u die regel toe aan de naamruimte ContosoNamespace. Bij het maken van deze regel moet u de juiste naamruimte en de resourcegroep opgeven waaraan de naamruimte is toegewezen. U hoeft echter geen informatie op te geven over de regel zelf: regelgegevens worden opgehaald uit het invoerbestand C:\Configuration\NamespaceAuthorizationRules.json.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

Hiermee geeft u het pad naar een JSON-bestand met configuratiegegevens voor de nieuwe autorisatieregel.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Hiermee geeft u de naamruimte aan waaraan de autorisatieregels worden toegewezen. Naamruimten bieden een manier om Notification Hubs te groeperen en te categoriseren. De nieuwe regels moeten worden toegewezen aan een bestaande naamruimte. De cmdlet New-AzNotificationHubsNamespaceAuthorizationRule kan geen nieuwe naamruimte maken.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroup

Hiermee geeft u de resourcegroep waaraan de naamruimte is toegewezen. Resourcegroepen organiseren items zoals naamruimten, notification hubs en autorisatieregels op manieren die eenvoudig voorraadbeheer en Azure-beheer helpen. U moet een bestaande resourcegroep gebruiken. Met deze cmdlet kan geen nieuwe resourcegroep worden gemaakt.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

Hiermee geeft u het object SharedAccessAuthorizationRuleAttributes met configuratiegegevens voor de nieuwe regels op.

Type:SharedAccessAuthorizationRuleAttributes
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

Uitvoerwaarden

SharedAccessAuthorizationRuleAttributes