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

Das Cmdlet Set-AzNotificationHubAuthorizationRule ä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
  • Send
  • 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 des SharedAccessAuthorizationRuleAttributes-Objekts erstellen und dann dieses Objekt mit den Eigenschaftswerten konfigurieren, die die Regel besitzen soll. Sie können das Objekt über .NET Framework konfigurieren. Sie können diese Eigenschaftswerte dann mithilfe des 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 InputFile-Parameter anwenden. Eine JSON-Datei ist eine Textdatei, die die Syntax wie folgt verwendet: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
    "Rechte": [
    "Listen",
    "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.json gefunden.

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

-Force

Bitten Sie nicht um Bestätigung.

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

-InputFile

Gibt den Pfad zu einer JSON-Datei an, die Konfigurationsinformationen für die neue Regel enthält.

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

-Namespace

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

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. Ressourcengruppen organisieren Elemente wie Namespaces, Benachrichtigungshubs und Autorisierungsregeln so, dass sie einfach die Bestandsverwaltung und die Azure-Verwaltung unterstützen.

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