Compartir a través de

Set-AzNotificationHubAuthorizationRule

  • Referencia
Módulo:
Az.NotificationHubs

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

Sintaxis

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
  • Enviar
  • 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 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": "W******Y=",
    "Derechos": [
    "Escuchar",
    "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.jsactivado.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

No pida confirmación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputFile

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

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SASRule

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

Tipo:SharedAccessAuthorizationRuleAttributes
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Salidas

SharedAccessAuthorizationRuleAttributes