Delen via

Set-AzNotificationHubAuthorizationRule

  • Referentie
Module:
Az.NotificationHubs

Hiermee stelt u autorisatieregels voor een Notification Hub in.

Syntax

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 cmdlet Set-AzNotificationHubAuthorizationRule 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 het object SharedAccessAuthorizationRuleAttributes maken en dat object vervolgens configureren met de eigenschapswaarden die u de regel wilt bezitten. U kunt het object configureren via .NET Framework. U kunt deze eigenschapswaarden vervolgens naar uw 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 via de parameter InputFile . Een JSON-bestand is een tekstbestand dat gebruikmaakt van syntaxis die vergelijkbaar is met: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
    "Rechten": [
    "Luister",
    "Verzenden"
    ]
    } Bij gebruik in combinatie met de cmdlet New-AzNotificationHubAuthorizationRule 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.json.

Parameters

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Vraag niet om bevestiging.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

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

Type:String
Position:3
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

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

Type:SharedAccessAuthorizationRuleAttributes
Position:3
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

Uitvoerwaarden

SharedAccessAuthorizationRuleAttributes