Cmdleten New-AzNotificationHubsNamespaceAuthorizationRule skapar en SAS-auktoriseringsregel (Signatur för delad åtkomst) och tilldelar den till ett namnområde för meddelandehubben.
Auktoriseringsregler hanterar användarrättigheter till namnområdet och till meddelandehubbarna som ingår i det namnområdet.
Den här cmdleten innehåller två sätt att skapa en ny auktoriseringsregel och tilldela den till ett namnområde.
Du kan skapa en instans av objektet SharedAccessAuthorizationRuleAttributes och sedan konfigurera objektet med de egenskapsvärden som du vill att den nya regeln ska ha.
Detta kan göras med hjälp av .NET Framework.
Du kan sedan kopiera dessa egenskapsvärden till din nya regel med hjälp av SASRule-parametern .
Du kan också skapa en JSON-fil (JavaScript Object Notation) som innehåller relevanta konfigurationsvärden och sedan tillämpa dessa värden med hjälp av parametern InputFile .
En JSON-fil är en textfil som använder syntax som liknar följande: { "Name": "ContosoAuthorizationRule", "PrimaryKey": "W******1Y=", "Rights": [ "Listen", "Send" ] } När den används tillsammans med cmdleten New-AzNotificationHubsNamespaceAuthorizationRule , I föregående JSON-exempel skapas en auktoriseringsregel med namnet ContosoAuthorizationRule som ger användarna behörighet att lyssna och skicka till namnområdet.
PrimaryKey som används för autentisering, kan genereras slumpmässigt med hjälp av följande Windows PowerShell-kommando: [Convert]::ToBase64String((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))
Exempel
Exempel 1: Skapa en auktoriseringsregel och tilldela den till ett namnområde
Det här kommandot skapar en auktoriseringsregel och tilldelar den regeln till namnområdet ContosoNamespace.
När du skapar den här regeln måste du ange lämpligt namnområde och den resursgrupp som namnområdet har tilldelats till.
Du behöver dock inte ange någon information om själva regeln: regelinformation hämtas från den indatafil som C:\Configuration\NamespaceAuthorizationRules.jspå.
Anger det namnområde som auktoriseringsreglerna ska tilldelas till.
Namnområden är ett sätt att gruppera och kategorisera meddelandehubbar.
De nya reglerna måste tilldelas till ett befintligt namnområde.
Cmdleten New-AzNotificationHubsNamespaceAuthorizationRule kan inte skapa ett nytt namnområde.
Anger den resursgrupp som namnområdet har tilldelats till.
Resursgrupper organiserar objekt som namnrymder, meddelandehubbar och auktoriseringsregler på ett sätt som bara hjälper till med lagerhantering och Azure administration.
Du måste använda en befintlig resursgrupp.
Den här cmdleten kan inte skapa en ny resursgrupp.
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.