Compartir a través de

New-AzNotificationHubsNamespaceAuthorizationRule

  • Referencia
Módulo:
Az.NotificationHubs

Crea una regla de autorización y asigna esa regla a un espacio de nombres del centro de notificaciones.

Sintaxis

New-AzNotificationHubsNamespaceAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-InputFile] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzNotificationHubsNamespaceAuthorizationRule
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-SASRule] <SharedAccessAuthorizationRuleAttributes>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzNotificationHubsNamespaceAuthorizationRule crea una regla de autorización de firma de acceso compartido (SAS) y la asigna a un espacio de nombres del centro de notificaciones. Las reglas de autorización administran los derechos de usuario en el espacio de nombres y en los centros de notificaciones contenidos con ese espacio de nombres. Este cmdlet proporciona dos maneras de crear una nueva regla de autorización y asignarla a un espacio de nombres. Puede crear una instancia del objeto SharedAccessAuthorizationRuleAttributes y, a continuación, configurar ese objeto con los valores de propiedad que desea que posea la nueva regla. Esto se puede hacer mediante .NET Framework. A continuación, puede copiar esos valores de propiedad en la nueva 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 mediante el parámetro InputFile. Un archivo JSON es un archivo de texto que usa una sintaxis similar a la siguiente: {
"Name": "ContosoAuthorizationRule",
"PrimaryKey": "W******1Y=",
"Derechos": [
"Escuchar",
"Enviar"
]
} Cuando se usa junto con el cmdlet New-AzNotificationHubsNamespaceAuthorizationRule, el ejemplo JSON anterior crea una regla de autorización denominada ContosoAuthorizationRule que proporciona derechos de escucha y envío a los usuarios al espacio de nombres. La PrimaryKey que se usa para la autenticación, se puede generar aleatoriamente mediante el siguiente comando de Windows PowerShell: [Convert]::ToBase64String((1...32 |% { [byte/](Get-Random -Minimum 0 -Maximum 255) }))

Ejemplos

Ejemplo 1: Crear una regla de autorización y asignarla a un espacio de nombres

New-AzNotificationHubAuthorizationRule -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configuration\NamespaceAuthorizationRules.json"

Este comando crea una regla de autorización y asigna esa regla al espacio de nombres ContosoNamespace. Al crear esta regla, debe especificar el espacio de nombres adecuado y el grupo de recursos al que está asignado el espacio de nombres. Sin embargo, no es necesario especificar ninguna información sobre la propia regla: la información de regla se extraerá del archivo de entrada C:\Configuration\NamespaceAuthorizationRules.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

-InputFile

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

Tipo:String
Posición:2
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 asignarán las reglas de autorización. Los espacios de nombres proporcionan una manera de agrupar y clasificar los centros de notificaciones. Las nuevas reglas deben asignarse a un espacio de nombres existente. El cmdlet New-AzNotificationHubsNamespaceAuthorizationRule no puede crear un nuevo espacio de nombres.

Tipo:String
Posición:1
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 espacio de nombres. 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. Debe usar un grupo de recursos existente. Este cmdlet no puede crear un nuevo grupo de recursos.

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 nuevas reglas.

Tipo:SharedAccessAuthorizationRuleAttributes
Posición:2
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