Udostępnij za pośrednictwem

Set-AzNotificationHubAuthorizationRule

  • Odwołanie
Moduł:
Az.NotificationHubs

Ustawia reguły autoryzacji dla centrum powiadomień.

Składnia

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

Opis

Polecenie cmdlet Set-AzNotificationHubAuthorizationRule modyfikuje regułę autoryzacji sygnatury dostępu współdzielonego (SAS) przypisaną do centrum powiadomień. Reguły autoryzacji zarządzają dostępem do centrów powiadomień przez tworzenie linków jako identyfikatorów URI na podstawie różnych poziomów uprawnień. Poziomy uprawnień mogą być jednym z następujących elementów:

  • Słuchać
  • Wyślij
  • Zarządzanie klientami jest kierowane do jednego z tych identyfikatorów URI na podstawie odpowiedniego poziomu uprawnień. Na przykład klient z uprawnieniem Nasłuchiwanie zostanie skierowany do identyfikatora URI dla tego uprawnienia. To polecenie cmdlet udostępnia dwa sposoby modyfikowania reguły autoryzacji przypisanej do centrum powiadomień. Dla jednego możesz utworzyć wystąpienie obiektu SharedAccessAuthorizationRuleAttributes obiektu, a następnie skonfigurować ten obiekt przy użyciu wartości właściwości, które mają być posiadane przez regułę. Obiekt można skonfigurować za pomocą programu .NET Framework. Następnie możesz skopiować te wartości właściwości do reguły przy użyciu parametru SASRule. Alternatywnie możesz utworzyć plik JSON (JavaScript Object Notation) zawierający odpowiednie wartości konfiguracji, a następnie zastosować te wartości za pomocą parametru InputFile. Plik JSON jest plikiem tekstowym, który używa składni podobnej do następującej: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "W******Y=",
    "Prawa": [
    "Słuchaj",
    "Wyślij"
    ]
    } W połączeniu z poleceniem cmdlet New-AzNotificationHubAuthorizationRule poprzedni przykład JSON modyfikuje regułę autoryzacji o nazwie ContosoAuthorizationRule w celu nadania użytkownikom uprawnień nasłuchiwania i wysyłania do centrum.

Przykłady

Przykład 1. Modyfikowanie reguły autoryzacji przypisanej do centrum powiadomień

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

To polecenie modyfikuje regułę autoryzacji przypisaną do centrum powiadomień o nazwie ContosoExternalHub. Należy określić przestrzeń nazw, w której znajduje się centrum, a także grupę zasobów przypisaną przez centrum. Informacje o modyfikowanej regule nie są zawarte w samym poleceniu. Zamiast tego informacje te znajdują się w pliku wejściowym C:\Configuration\AuthorizationRules.js.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Nie pytaj o potwierdzenie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputFile

Określa ścieżkę do pliku JSON zawierającego informacje o konfiguracji dla nowej reguły.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Namespace

Określa przestrzeń nazw, do której przypisano centrum powiadomień. Przestrzenie nazw umożliwiają grupowanie i kategoryzowanie centrów powiadomień.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NotificationHub

Określa centrum powiadomień, do którego to polecenie cmdlet przypisuje reguły autoryzacji. Centra powiadomień są używane do wysyłania powiadomień wypychanych do wielu klientów niezależnie od używanego przez tych klientów.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroup

Określa grupę zasobów, do której przypisano centrum powiadomień. Grupy zasobów organizują elementy, takie jak przestrzenie nazw, centra powiadomień i reguły autoryzacji w sposób, który pomaga po prostu zarządzać spisem i administrować platformą Azure.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SASRule

Określa obiekt SharedAccessAuthorizationRuleAttributes zawierający informacje o konfiguracji dla zmodyfikowanych reguł autoryzacji.

Typ:SharedAccessAuthorizationRuleAttributes
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

SharedAccessAuthorizationRuleAttributes