Compartir a través de

Set-AzNotificationHubAuthorizationRule

  • Referencia
Módulo:
Az.NotificationHubs

Establece reglas de autorización para un centro de notificaciones.

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

El cmdlet Set-AzNotificationHubAuthorizationRule modifica una regla de autorización de firma de acceso compartido (SAS) asignada a un centro de notificaciones. Las reglas de autorización administran el acceso a los centros de notificaciones mediante la creación de vínculos, como URI, en función de distintos niveles de permisos. Los niveles de permisos pueden ser uno de los siguientes:

  • Escuchar
  • Envío
  • Administrar clientes se dirige a uno de estos URI en función del nivel de permisos adecuado. Por ejemplo, un cliente dado el permiso de escucha se dirigirá al URI para ese permiso. Este cmdlet proporciona dos maneras de modificar una regla de autorización asignada a un centro de notificaciones. Para uno, puede crear una instancia del objeto SharedAccessAuthorizationRuleAttributes y, a continuación, configurar ese objeto con los valores de propiedad que desea que posea la regla. Puede configurar el objeto a través de .NET Framework. A continuación, puede copiar esos valores de propiedad en la regla mediante el parámetro SASRule . Como alternativa, puede crear un archivo JSON (notación de objetos JavaScript) que contenga los valores de configuración pertinentes y, a continuación, aplicar esos valores a través del parámetro InputFile . Un archivo JSON es un archivo de texto que usa sintaxis similar a esta: { "Name": "ContosoAuthorizationRule",
    "PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
    "Derechos": [
    "Listen",
    "Enviar"
    ]
    } Cuando se usa junto con el cmdlet New-AzNotificationHubAuthorizationRule, el ejemplo JSON anterior modifica una regla de autorización denominada ContosoAuthorizationRule para conceder a los usuarios derechos de escucha y envío al centro.

Ejemplos

Ejemplo 1: Modificación de una regla de autorización asignada a un centro de notificaciones

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

Este comando modifica una regla de autorización asignada al centro de notificaciones denominado ContosoExternalHub. Debe especificar el espacio de nombres donde se encuentra el centro, así como el grupo de recursos al que está asignado el centro. La información sobre la regla que se modifica no se incluye en el propio comando. En su lugar, esa información se encuentra en el archivo de entrada C:\Configuration\AuthorizationRules.json.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

No pida confirmación.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

Especifica la ruta de acceso a un archivo JSON que contiene información de configuración para la nueva regla.

Tipo:String
Position:3
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Especifica el espacio de nombres al que se asigna el centro de notificaciones. Los espacios de nombres proporcionan una manera de agrupar y clasificar los centros de notificaciones.

Tipo:String
Position:1
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-NotificationHub

Especifica el centro de notificaciones al que este cmdlet asigna reglas de autorización. Los centros de notificaciones se usan para enviar notificaciones push a varios clientes independientemente del utilizado por esos clientes.

Tipo:String
Position:2
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroup

Especifica el grupo de recursos al que se asigna el centro de notificaciones. Los grupos de recursos organizan elementos como espacios de nombres, centros de notificaciones y reglas de autorización de maneras que ayudan simplemente a la administración del inventario y a la administración de Azure.

Tipo:String
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

Especifica el objeto SharedAccessAuthorizationRuleAttributes que contiene información de configuración para las reglas de autorización que se modifican.

Tipo:SharedAccessAuthorizationRuleAttributes
Position:3
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Salidas

SharedAccessAuthorizationRuleAttributes