New-AzNotificationHubsNamespaceAuthorizationRule

  • Odwołanie
Moduł:
Az.NotificationHubs

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 , 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żna 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": "WE4qH0398AyXjlekt56gg1gM3NHoMs29KkUnnpUk01Y=",
"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. Klucz podstawowy 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.json.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-SASRule

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

Type:SharedAccessAuthorizationRuleAttributes
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

Dane wyjściowe

SharedAccessAuthorizationRuleAttributes