Dela via

Set-AzNotificationHubAuthorizationRule

  • Referens
Modul:
Az.NotificationHubs

Anger auktoriseringsregler för en meddelandehubb.

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

Set-AzNotificationHubAuthorizationRule cmdlet ändrar en SAS-auktoriseringsregel (Signatur för delad åtkomst) som tilldelats en meddelandehubb. Auktoriseringsregler hanterar åtkomsten till dina meddelandehubbar genom att skapa länkar, som URI:er, baserat på olika behörighetsnivåer. Behörighetsnivåer kan vara något av följande:

  • Lyssna
  • Sända
  • Hantera klienter dirigeras till en av dessa URI:er baserat på lämplig behörighetsnivå. Till exempel dirigeras en klient med behörigheten Lyssna till URI:n för den behörigheten. Den här cmdleten innehåller två sätt att ändra en auktoriseringsregel som tilldelats en meddelandehubb. För det första kan du skapa en instans av SharedAccessAuthorizationRuleAttributes objekt och sedan konfigurera objektet med de egenskapsvärden som du vill att regeln ska ha. Du kan konfigurera objektet via .NET Framework. Du kan sedan kopiera dessa egenskapsvärden till regeln med hjälp av SASRule- parameter. Du kan också skapa en JSON-fil (JavaScript Object Notation) som innehåller relevanta konfigurationsvärden och sedan tillämpa dessa värden via parametern InputFile. En JSON-fil är en textfil som använder syntax som liknar den här: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "W******Y=",
    "Rättigheter": [
    "Lyssna",
    "Skicka"
    ]
    } När det används tillsammans med cmdleten New-AzNotificationHubAuthorizationRule ändrar det föregående JSON-exemplet en auktoriseringsregel med namnet ContosoAuthorizationRule för att ge användarna lyssnar- och sändningsrättigheter till hubben.

Exempel

Exempel 1: Ändra en auktoriseringsregel som tilldelats en meddelandehubb

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

Det här kommandot ändrar en auktoriseringsregel som tilldelats meddelandehubben med namnet ContosoExternalHub. Du måste ange namnområdet där hubben finns samt den resursgrupp som hubben har tilldelats. Information om regeln som ändras ingår inte i själva kommandot. I stället finns den informationen i indatafilen C:\Configuration\AuthorizationRules.jspå.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Be inte om bekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputFile

Anger sökvägen till en JSON-fil som innehåller konfigurationsinformation för den nya regeln.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Namespace

Anger det namnområde som meddelandehubben har tilldelats. Namnområden är ett sätt att gruppera och kategorisera meddelandehubbar.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NotificationHub

Anger den meddelandehubb som den här cmdleten tilldelar auktoriseringsregler till. Meddelandehubbar används för att skicka push-meddelanden till flera klienter oavsett vilka klienter som används.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroup

Anger den resursgrupp som meddelandehubben har tilldelats. Resursgrupper organiserar objekt som namnrymder, meddelandehubbar och auktoriseringsregler på ett sätt som bara hjälper till med inventeringshantering och Azure-administration.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SASRule

Anger SharedAccessAuthorizationRuleAttributes objekt som innehåller konfigurationsinformation för de auktoriseringsregler som ändras.

Typ:SharedAccessAuthorizationRuleAttributes
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Utdata

SharedAccessAuthorizationRuleAttributes