Share via

New-AzNotificationHubsNamespaceAuthorizationRule

  • Reference
Modul:
Az.NotificationHubs

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

Syntax

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 Objektu SharedAccessAuthorizationRuleAttributes 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": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
"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ů. Primární klíč , 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.json.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-DefaultProfile

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

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

-InputFile

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

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

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

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

-SASRule

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

Výstupy

SharedAccessAuthorizationRuleAttributes