Freigeben über


New-AzNotificationHubAuthorizationRule

Erstellt eine Autorisierungsregel und weist die Regel einem Benachrichtigungshub zu.

Syntax

New-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-InputFile] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzNotificationHubAuthorizationRule erstellt eine Sas-Autorisierungsregel (Shared Access Signature). Autorisierungsregeln werden verwendet, um den Zugriff auf Ihre Benachrichtigungshubs zu verwalten. Dies erfolgt durch die Erstellung von Links als URIs basierend auf unterschiedlichen Berechtigungsstufen. Clients werden basierend auf der entsprechenden Berechtigungsstufe an eine dieser URIs weitergeleitet. Beispielsweise wird ein Client mit der Berechtigung "Listen" an den URI für diese Berechtigung weitergeleitet.

Beispiele

Beispiel 1: Erstellen einer Autorisierungsregel für den Benachrichtigungshub

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -NotificationHub "ContosoInternalHub" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\ExternalAccessRule.json"

Mit diesem Befehl wird eine neue Autorisierungsregel erstellt und dem Benachrichtigungshub "ContosoInternalHub" zugewiesen. Dieser Hub befindet sich im ContosoNamespace-Namespace und wird der ContosoNotificationsGroup-Ressourcengruppe zugewiesen. Beachten Sie, dass alle Konfigurationsinformationen für die Regel, einschließlich des Regelnamens, aus der Eingabedatei C:\Configuration\ExternalAccessRule.json entnommen werden.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-InputFile

Gibt die Eingabedatei für die Autorisierungsregel an, die dieses Cmdlet erstellt.

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

-Namespace

Gibt den Namespace an, dem die Autorisierungsregeln zugewiesen werden. Namespaces bieten eine Möglichkeit zum Gruppieren und Kategorisieren von Benachrichtigungshubs.

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

-NotificationHub

Gibt den Benachrichtigungshub an, dem die Autorisierungsregeln zugewiesen werden. Benachrichtigungshubs werden verwendet, um Pushbenachrichtigungen unabhängig von der Plattform, die von diesen Clients verwendet wird, an mehrere Clients zu senden. Beachten Sie, dass Sie den Namen eines vorhandenen Benachrichtigungshubs angeben müssen. Das Cmdlet New-AzNotificationHubAuthorizationRule kann keine neuen Benachrichtigungshubs erstellen.

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

-ResourceGroup

Gibt die Ressourcengruppe an, der der Benachrichtigungshub zugewiesen ist.

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

-SASRule

Gibt das SharedAccessAuthorizationRuleAttributes -Objekt an, das Konfigurationsinformationen für die neuen Regeln enthält.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

String

Ausgaben

SharedAccessAuthorizationRuleAttributes