Sdílet prostřednictvím

New-AzNotificationHubsNamespaceAuthorizationRule

  • Reference
Modul:
Az.NotificationHubs

Vytvoří autorizační pravidlo a přiřadí toto pravidlo k oboru názvů centra oznámení.

Syntaxe

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

Description

Rutina New-AzNotificationHubsNamespaceAuthorizationRule vytvoří autorizační pravidlo sdíleného přístupového podpisu (SAS) a přiřadí ho k oboru názvů centra oznámení. Autorizační pravidla spravují uživatelská práva k oboru názvů a centra oznámení obsažená v tomto oboru názvů. Tato rutina poskytuje dva způsoby, jak vytvořit nové autorizační pravidlo a přiřadit ho k oboru názvů. Můžete vytvořit instanci SharedAccessAuthorizationRuleAttributes objekt a pak tento objekt nakonfigurovat s hodnotami vlastností, které má nové pravidlo mít. To lze provést pomocí rozhraní .NET Framework. Tyto hodnoty vlastností pak můžete zkopírovat do nového pravidla pomocí parametru SASRule. Alternativně můžete vytvořit soubor JSON (JavaScript Object Notation), který obsahuje relevantní konfigurační hodnoty, a pak tyto hodnoty použít pomocí parametru InputFile. Soubor JSON je textový soubor, který používá syntaxi podobnou následující: {
"Name": "ContosoAuthorizationRule",
"PrimaryKey": "W******1Y=",
"Práva": [
"Poslouchej",
"Odeslat"
]
} Při použití ve spojení s rutinou New-AzNotificationHubsNamespaceAuthorizationRule vytvoří předchozí ukázka JSON autorizační pravidlo s názvem ContosoAuthorizationRule, které uživatelům poskytuje naslouchat a odesílat práva k oboru názvů. PrimaryKey, který se používá k ověřování, lze náhodně vygenerovat pomocí následujícího příkazu Windows PowerShellu: [Convert]::ToBase64String(((1..32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Příklady

Příklad 1: Vytvoření autorizačního pravidla a jeho přiřazení k oboru názvů

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

Tento příkaz vytvoří autorizační pravidlo a přiřadí toto pravidlo k oboru názvů ContosoNamespace. Při vytváření tohoto pravidla musíte zadat příslušný obor názvů a skupinu prostředků, ke které je obor názvů přiřazen. Nemusíte však zadávat žádné informace o samotném pravidlu: informace o pravidle budou převzaty ze vstupního souboru C:\Configuration\NamespaceAuthorizationRules.js.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputFile

Určuje cestu k souboru JSON obsahujícímu konfigurační informace pro nové autorizační pravidlo.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Namespace

Určuje obor názvů, ke kterému budou přiřazena autorizační pravidla. Obory názvů poskytují způsob, jak seskupit a kategorizovat centra oznámení. Nová pravidla musí být přiřazena k existujícímu oboru názvů. Rutina New-AzNotificationHubsNamespaceAuthorizationRule nemůže vytvořit nový obor názvů.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroup

Určuje skupinu prostředků, ke které je obor názvů přiřazen. Skupiny prostředků uspořádají položky, jako jsou obory názvů, centra oznámení a autorizační pravidla, a to způsobem, který pomáhá jednoduše spravovat inventář a správu Azure. Musíte použít existující skupinu prostředků. Tato rutina nemůže vytvořit novou skupinu prostředků.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SASRule

Určuje SharedAccessAuthorizationRuleAttributes objekt obsahující informace o konfiguraci pro nová pravidla.

Typ:SharedAccessAuthorizationRuleAttributes
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

SharedAccessAuthorizationRuleAttributes