Udostępnij za pośrednictwem


New-AzNotificationHubsNamespaceAuthorizationRule

Tworzy regułę autoryzacji i przypisuje tę regułę do przestrzeni nazw centrum powiadomień.

Składnia

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

Opis

Polecenie cmdlet New-AzNotificationHubsNamespaceAuthorizationRule tworzy regułę autoryzacji sygnatury dostępu współdzielonego (SAS) i przypisuje ją do przestrzeni nazw centrum powiadomień. Reguły autoryzacji zarządzają prawami użytkowników do przestrzeni nazw oraz do centrów powiadomień zawartych w tej przestrzeni nazw. To polecenie cmdlet udostępnia dwa sposoby tworzenia nowej reguły autoryzacji i przypisywania jej do przestrzeni nazw. 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 nową regułę. Można to zrobić przy użyciu programu .NET Framework. Następnie możesz skopiować te wartości właściwości do nowej 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 przy użyciu parametru InputFile. Plik JSON jest plikiem tekstowym, który używa składni podobnej do następującej: {
"Name": "ContosoAuthorizationRule",
"PrimaryKey": "W******1Y=",
"Prawa": [
"Słuchaj",
"Wyślij"
]
} W połączeniu z poleceniem cmdlet New-AzNotificationHubsNamespaceAuthorizationRule, poprzedni przykład JSON tworzy regułę autoryzacji o nazwie ContosoAuthorizationRule, która daje użytkownikom prawa nasłuchiwania i wysyłania do przestrzeni nazw. PrimaryKey używany do uwierzytelniania można wygenerować losowo przy użyciu następującego polecenia programu Windows PowerShell: [Convert]::ToBase64String((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Przykłady

Przykład 1: Tworzenie reguły autoryzacji i przypisywanie jej do przestrzeni nazw

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

To polecenie tworzy regułę autoryzacji i przypisuje tę regułę do przestrzeni nazw ContosoNamespace. Podczas tworzenia tej reguły należy określić odpowiednią przestrzeń nazw i grupę zasobów, do której przypisano przestrzeń nazw. Nie trzeba jednak określać żadnych informacji o samej regule: informacje o regule zostaną pobrane z pliku wejściowego C:\Configuration\NamespaceAuthorizationRules.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

-InputFile

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

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

-Namespace

Określa przestrzeń nazw, do której zostaną przypisane reguły autoryzacji. Przestrzenie nazw umożliwiają grupowanie i kategoryzowanie centrów powiadomień. Nowe reguły muszą być przypisane do istniejącej przestrzeni nazw. Polecenie cmdlet New-AzNotificationHubsNamespaceAuthorizationRule nie może utworzyć nowej przestrzeni nazw.

Typ:String
Position:1
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 przestrzeń nazw. 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. Musisz użyć istniejącej grupy zasobów. To polecenie cmdlet nie może utworzyć nowej grupy zasobów.

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 nowych reguł.

Typ:SharedAccessAuthorizationRuleAttributes
Position:2
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

Dane wyjściowe