Share via

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.

Syntax

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 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 mediante el parámetro InputFile . Un archivo JSON es un archivo de texto que usa una sintaxis similar a la siguiente: {
"Name": "ContosoAuthorizationRule",
"PrimaryKey": "WE4qH0398AyXjlekt56gg1gMR3NHoMs29KkUnnpUk01Y=",
"Derechos": [
"Listen",
"Enviar"
]
} Cuando se usa junto con el cmdlet New-AzNotificationHubsNamespaceAuthorizationRule , el ejemplo JSON anterior crea una regla de autorización denominada ContosoAuthorizationRule que proporciona a los usuarios derechos de escucha y envío al espacio de nombres. 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.json.

Parámetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required: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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required: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 de autorización.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SASRule

Especifica el objeto SharedAccessAuthorizationRuleAttributes que contiene información de configuración para las nuevas reglas.

Type:SharedAccessAuthorizationRuleAttributes
Position:2
Default value:None
Required: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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Salidas

SharedAccessAuthorizationRuleAttributes