Delen via

Set-AzNotificationHubAuthorizationRule

  • Referentie
Module:
Az.NotificationHubs

Hiermee stelt u autorisatieregels voor een Notification Hub in.

Syntaxis

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

De Set-AzNotificationHubAuthorizationRule cmdlet wijzigt een SAS-autorisatieregel (Shared Access Signature) die is toegewezen aan een Notification Hub. Autorisatieregels beheren de toegang tot uw Notification Hubs door koppelingen, als URI's, te maken op basis van verschillende machtigingsniveaus. Machtigingsniveaus kunnen een van de volgende zijn:

  • Luisteren
  • Verzenden
  • Clients beheren worden omgeleid naar een van deze URI's op basis van het juiste machtigingsniveau. Een client met de listen-machtiging wordt bijvoorbeeld omgeleid naar de URI voor die machtiging. Deze cmdlet biedt twee manieren om een autorisatieregel te wijzigen die is toegewezen aan een Notification Hub. Voor één kunt u een exemplaar van de SharedAccessAuthorizationRuleAttributes object maken en dat object vervolgens configureren met de eigenschapswaarden die u wilt dat de regel bezit. U kunt het object configureren via .NET Framework. U kunt deze eigenschapswaarden vervolgens naar uw regel kopiëren met behulp van SASRule-parameter. U kunt ook een JSON-bestand (JavaScript Object Notation) maken met de relevante configuratiewaarden en deze waarden vervolgens toepassen via de parameter InputFile. Een JSON-bestand is een tekstbestand dat gebruikmaakt van syntaxis die vergelijkbaar is met: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "W******Y=",
    "Rechten": [
    "Luister",
    "Verzenden"
    ]
    } Wanneer het in combinatie met de cmdlet New-AzNotificationHubAuthorizationRule wordt gebruikt, wijzigt het voorgaande JSON-voorbeeld een autorisatieregel met de naam ContosoAuthorizationRule om gebruikers de rechten voor luisteren en verzenden naar de hub te geven.

Voorbeelden

Voorbeeld 1: Een autorisatieregel wijzigen die is toegewezen aan een Notification Hub

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

Met deze opdracht wordt een autorisatieregel gewijzigd die is toegewezen aan de Notification Hub met de naam ContosoExternalHub. U moet de naamruimte opgeven waar de hub zich bevindt, evenals de resourcegroep waaraan de hub is toegewezen. Informatie over de regel die wordt gewijzigd, wordt niet opgenomen in de opdracht zelf. In plaats daarvan vindt u die informatie in het invoerbestand C:\Configuration\AuthorizationRules.jsaan.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Vraag niet om bevestiging.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputFile

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

Type:String
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Namespace

Hiermee geeft u de naamruimte aan waaraan de Notification Hub is toegewezen. Naamruimten bieden een manier om Notification Hubs te groeperen en te categoriseren.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NotificationHub

Hiermee geeft u de Notification Hub waaraan deze cmdlet autorisatieregels toewijst. Notification Hubs worden gebruikt voor het verzenden van pushmeldingen naar meerdere clients, ongeacht het gebruik door deze clients.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroup

Hiermee geeft u de resourcegroep aan waaraan de Notification Hub is toegewezen. Resourcegroepen organiseren items zoals naamruimten, notification hubs en autorisatieregels op manieren die eenvoudig voorraadbeheer en Azure-beheer helpen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SASRule

Hiermee geeft u de SharedAccessAuthorizationRuleAttributes object dat configuratiegegevens bevat voor de autorisatieregels die worden gewijzigd.

Type:SharedAccessAuthorizationRuleAttributes
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

SharedAccessAuthorizationRuleAttributes