Share via

Set-AzNotificationHubAuthorizationRule

  • Reference
Modul:
Az.NotificationHubs

Nastaví autorizační pravidla pro centrum oznámení.

Syntax

Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-InputFile] <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzNotificationHubAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHub] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzNotificationHubAuthorizationRule upravuje autorizační pravidlo sdíleného přístupového podpisu (SAS) přiřazené k centru oznámení. Autorizační pravidla spravují přístup k vašim centrem oznámení vytvořením odkazů, jako identifikátorů URI, na základě různých úrovní oprávnění. Úrovně oprávnění můžou být následující:

  • Naslouchat
  • Odeslat
  • Správa klientů se směruje na jednu z těchto identifikátorů URI na základě příslušné úrovně oprávnění. Například klient s oprávněním Listen se bude směrovat na identifikátor URI pro toto oprávnění. Tato rutina poskytuje dva způsoby, jak upravit autorizační pravidlo přiřazené k centru oznámení. Pro jednu můžete vytvořit instanci SharedAccessAuthorizationRuleAttributes objektu a pak tento objekt nakonfigurovat s hodnotami vlastností, které má pravidlo mít. Objekt můžete nakonfigurovat prostřednictvím rozhraní .NET Framework. Tyto hodnoty vlastností pak můžete zkopírovat do 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 prostřednictvím parametru InputFile . Soubor JSON je textový soubor, který používá syntaxi podobnou této: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
    "Práva": [
    "Poslouchej",
    "Odeslat"
    ]
    } Pokud se používá ve spojení s rutinou New-AzNotificationHubAuthorizationRule, předchozí ukázka JSON upraví autorizační pravidlo s názvem ContosoAuthorizationRule, aby uživatelům poskytlo naslouchat a odesílat práva do centra.

Příklady

Příklad 1: Úprava autorizačního pravidla přiřazeného k centru oznámení

Set-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationGroup" -NotificationHub "ContosoExternalHub" -InputFile "C:\Configuration\AuthorizationRules.json"

Tento příkaz upraví autorizační pravidlo přiřazené k centru oznámení s názvem ContosoExternalHub. Musíte zadat obor názvů, ve kterém je centrum umístěné, a také skupinu prostředků, kterou má centrum přiřazené. Informace o pravidle, které je změněno, nejsou zahrnuty do samotného příkazu. Místo toho se informace nacházejí ve vstupním souboru C:\Configuration\AuthorizationRules.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

-Force

Nepožádejte o potvrzení.

Type:SwitchParameter
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é pravidlo.

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

-Namespace

Určuje obor názvů, ke kterému je centrum oznámení přiřazeno. Obory názvů poskytují způsob, jak seskupit a kategorizovat centra oznámení.

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

-NotificationHub

Určuje centrum oznámení, ke kterému tato rutina přiřadí autorizační pravidla. Centra oznámení se používají k odesílání nabízených oznámení více klientům bez ohledu na to, co používají tito klienti.

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

-ResourceGroup

Určuje skupinu prostředků, ke které je centrum oznámení přiřazeno. 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.

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 autorizační pravidla, která jsou upravena.

Type:SharedAccessAuthorizationRuleAttributes
Position:3
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