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.jsübernommen werden.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputFile

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

Typ:String
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Namespace

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

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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 Cmdlet kann keine neuen Benachrichtigungshubs erstellen.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroup

Gibt die Ressourcengruppe an, der der Benachrichtigungshub zugewiesen ist.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SASRule

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

Typ:SharedAccessAuthorizationRuleAttributes
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

SharedAccessAuthorizationRuleAttributes