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 |