New-SBAuthorizationRule

New-SBAuthorizationRule

Este cmdlet crea una regla nueva de autorización de secreto de acceso compartido (SAS) para un espacio de nombres de Service Bus Service.

Sintaxis

Parameter Set: Default
New-SBAuthorizationRule -Name <String> -NamespaceName <String> [-PrimaryKey <String> ] [-Rights <AccessRight[]> ] [-SecondaryKey <String> ] [ <CommonParameters>]

Descripción detallada

Ejecute New-SBAuthorizationRule para crear una regla de autorización de secreto de acceso compartido (SAS) nueva en su CmdLetsespacio de nombres de servicio. Una regla de autorización SAS permite a los clientes administrar e intercambiar mensajes con entidades de mensajería definidas dentro del ámbito del espacio de nombres. Utilice las reglas de autorización SAS cuando no pueda utilizar usuarios unidos a un dominio como inquilino. Una regla de autorización SAS tiene un ámbito (el CmdLets espacio de nombres de servicio), un conjunto de derechos (administrar, enviaro recibir), y una pareja de claves (principal y secundaria) que los clientes pueden utilizar.

Parámetros

-Name<String>

El nombre de la regla de autorización que acaba de crear.

-NamespaceName<String>

El ámbito de la regla de autorización que acaba de crear.

-PrimaryKey<String>

La clave que utilizará esta regla de autorización. Si no se indica, Service Bus genera una clave. Puede definir explícitamente este parámetro si desea reinstalar una granja y mantener el cliente inalterado.

-Rights<AccessRight[]>

La lista separada por comas de derechos de acceso activados con esta regla de autorización. Los derechos de acceso incluyen permisos de administración, envío y escucha.

-SecondaryKey<String>

La clave que utilizará esta regla de autorización. Si no se indica, Service Bus genera una clave. Puede definir explícitamente este parámetro si desea reinstalar una granja y mantener el cliente inalterado.

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

Ejemplos

Ejemplo 1

El ejemplo siguiente crea una regla nueva para myNamespace denominada myRule. La regla que acaba de crear otorga derechos de acceso de envío y escucha a los clientes que utilizan la clave. Observe que, en este ejemplo, la clave se genera automáticamente y se requiere una llamada a Get-SBAuthorizationRule .

PS C:\> New-SBAuthorizationRule -NamespaceName mynamespace -name myRule -Rights send,listen

Ejemplo 2

El ejemplo siguiente crea una regla nueva para myNamespace denominada myRule2. La regla acabada de crear utiliza una clave principal predefinida (una cadena ASCII de 32 bytes).

PS C:\> $myKey = '!@123456789012345678901234567890'PS C:\>$base64Key = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($myKey))PS C:\>New-SBAuthorizationRule -NamespaceName myNamespace -name myrule2 -PrimaryKey $base64Key

Service Bus 1.0 MSDN Community Forum