Sdílet prostřednictvím

Set-AzNotificationHubAuthorizationRule

  • Reference
Modul:
Az.NotificationHubs

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

Syntaxe

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 upraví 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
  • Poslat
  • 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 z nich můžete vytvořit instanci SharedAccessAuthorizationRuleAttributes objekt 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 do pravidla zkopírovat 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": "W******Y=",
    "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 posí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.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

-Force

Nepožádejte o potvrzení.

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

Typ:String
Position:3
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 je centrum oznámení přiřazeno. Obory názvů poskytují způsob, jak seskupit a kategorizovat centra oznámení.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String
Position:2
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 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.

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, který obsahuje konfigurační informace pro autorizační pravidla, která jsou upravena.

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