Freigeben über

New-AzNotificationHubsNamespaceAuthorizationRule

  • Referenz
Modul:
Az.NotificationHubs

Erstellt eine Autorisierungsregel und weist diese Regel einem Benachrichtigungshub-Namespace zu.

Syntax

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

Beschreibung

Das cmdlet New-AzNotificationHubsNamespaceAuthorizationRule erstellt eine SAS-Autorisierungsregel (Shared Access Signature) und weist sie einem Benachrichtigungshub-Namespace zu. Autorisierungsregeln verwalten Benutzerrechte für den Namespace und die Benachrichtigungshubs, die in diesem Namespace enthalten sind. Dieses Cmdlet bietet zwei Möglichkeiten, eine neue Autorisierungsregel zu erstellen und einem Namespace zuzuweisen. Sie können eine Instanz des SharedAccessAuthorizationRuleAttributes Objekt erstellen und dann dieses Objekt mit den Eigenschaftswerten konfigurieren, die die neue Regel besitzen soll. Dies kann mithilfe von .NET Framework erfolgen. Sie können diese Eigenschaftswerte dann mithilfe SASRule--Parameters in Ihre neue Regel kopieren. Alternativ können Sie eine JSON-Datei (JavaScript Object Notation) erstellen, die die relevanten Konfigurationswerte enthält, und diese Werte dann mithilfe des InputFile--Parameters anwenden. Eine JSON-Datei ist eine Textdatei, die die Syntax wie folgt verwendet: {
"Name": "ContosoAuthorizationRule",
"PrimaryKey": "W******1Y=",
"Rechte": [
"Hören",
"Senden"
]
} Bei Verwendung in Verbindung mit dem New-AzNotificationHubsNamespaceAuthorizationRule Cmdlet erstellt das vorherige JSON-Beispiel eine Autorisierungsregel namens ContosoAuthorizationRule, die Benutzern Listen- und Senderechte an den Namespace gewährt. Die PrimaryKey-, die für die Authentifizierung verwendet wird, kann zufällig mithilfe des folgenden Windows PowerShell-Befehls generiert werden: [Konvertieren]::ToBase64String((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Beispiele

Beispiel 1: Erstellen einer Autorisierungsregel und Zuweisen einer Autorisierungsregel zu einem Namespace

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\NamespaceAuthorizationRules.json"

Dieser Befehl erstellt eine Autorisierungsregel und weist diese Regel dem Namespace ContosoNamespace zu. Beim Erstellen dieser Regel müssen Sie den entsprechenden Namespace und die Ressourcengruppe angeben, der der Namespace zugewiesen ist. Sie müssen jedoch keine Informationen zur Regel selbst angeben: Regelinformationen werden aus der Eingabedatei C:\Configuration\NamespaceAuthorizationRules.jsentnommen.

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 den Pfad zu einer JSON-Datei an, die Konfigurationsinformationen für die neue Autorisierungsregel enthält.

Typ:String
Position:2
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. Die neuen Regeln müssen einem vorhandenen Namespace zugewiesen werden. Der New-AzNotificationHubsNamespaceAuthorizationRule Cmdlet kann keinen neuen Namespace erstellen.

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

-ResourceGroup

Gibt die Ressourcengruppe an, der der Namespace zugewiesen ist. Ressourcengruppen organisieren Elemente wie Namespaces, Benachrichtigungshubs und Autorisierungsregeln so, dass sie einfach die Bestandsverwaltung und die Azure-Verwaltung unterstützen. Sie müssen eine vorhandene Ressourcengruppe verwenden. Dieses Cmdlet kann keine neue Ressourcengruppe erstellen.

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:2
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