Freigeben über

Set-AzNotificationHubAuthorizationRule

  • Referenz
Modul:
Az.NotificationHubs

Legt Autorisierungsregeln für einen Benachrichtigungshub fest.

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>]

Beschreibung

Die Set-AzNotificationHubAuthorizationRule Cmdlet ändert eine SAS-Autorisierungsregel (Shared Access Signature), die einem Benachrichtigungshub zugewiesen ist. Autorisierungsregeln verwalten den Zugriff auf Ihre Benachrichtigungshubs durch die Erstellung von Links als URIs basierend auf verschiedenen Berechtigungsstufen. Berechtigungsstufen können eine der folgenden Sein:

  • Zuhören
  • Senden
  • Verwalten von 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. Dieses Cmdlet bietet zwei Möglichkeiten zum Ändern einer Autorisierungsregel, die einem Benachrichtigungshub zugewiesen ist. Zum einen können Sie eine Instanz der SharedAccessAuthorizationRuleAttributes Objekt erstellen und dieses Objekt dann mit den Eigenschaftswerten konfigurieren, die die Regel besitzen soll. Sie können das Objekt über .NET Framework konfigurieren. Anschließend können Sie diese Eigenschaftswerte mithilfe SASRule-Parameters in Ihre Regel kopieren. Alternativ können Sie eine JSON-Datei (JavaScript Object Notation) erstellen, die die relevanten Konfigurationswerte enthält, und diese Werte dann über den parameter InputFile anwenden. Eine JSON-Datei ist eine Textdatei, die die Syntax wie folgt verwendet: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "W******Y=",
    "Rechte": [
    "Hören",
    "Senden"
    ]
    } Bei Verwendung in Verbindung mit dem Cmdlet New-AzNotificationHubAuthorizationRule ändert das vorherige JSON-Beispiel eine Autorisierungsregel namens ContosoAuthorizationRule, um Benutzern Listen- und Senderechte an den Hub zu gewähren.

Beispiele

Beispiel 1: Ändern einer Autorisierungsregel, die einem Benachrichtigungshub zugewiesen ist

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

Mit diesem Befehl wird eine Autorisierungsregel geändert, die dem Benachrichtigungshub namens ContosoExternalHub zugewiesen ist. Sie müssen den Namespace angeben, in dem sich der Hub befindet, sowie die Ressourcengruppe, der der Hub zugewiesen ist. Informationen zur geänderten Regel sind nicht im Befehl selbst enthalten. Stattdessen werden diese Informationen in der Eingabedatei C:\Configuration\AuthorizationRules.jsgefunden.

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

-Force

Bitten Sie nicht um Bestätigung.

Typ:SwitchParameter
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 Regel enthält.

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

-Namespace

Gibt den Namespace an, dem der Benachrichtigungshub zugewiesen ist. 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 dieses Cmdlet Autorisierungsregeln zuweist. Benachrichtigungshubs werden verwendet, um Pushbenachrichtigungen unabhängig von den von diesen Clients verwendeten Clients an mehrere Clients zu senden.

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

-ResourceGroup

Gibt die Ressourcengruppe an, der der Benachrichtigungshub zugewiesen ist. Ressourcengruppen organisieren Elemente wie Namespaces, Benachrichtigungshubs und Autorisierungsregeln so, dass sie einfach die Bestandsverwaltung und die Azure-Verwaltung unterstützen.

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 geänderten Autorisierungsregeln 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