New-​Azure​Rm​Relay​Authorization​Rule

Creates a new authorization rule for the specified Relay entities (Namespace/WcfRelay/HybridConnection).

Syntax

New-AzureRmRelayAuthorizationRule
   [-ResourceGroupName] <String>
   [[-Namespace] <String>]
   [-HybridConnection] <String>
   [-Name] <String>
   [-Confirm]
   -Rights <String[]>
   [-WhatIf]
   [<CommonParameters>]
New-AzureRmRelayAuthorizationRule
   [-ResourceGroupName] <String>
   [-Namespace] <String>
   [-Name] <String>
   [-Confirm]
   -Rights <String[]>
   [-WhatIf]
   [<CommonParameters>]
New-AzureRmRelayAuthorizationRule
   [-ResourceGroupName] <String>
   [[-Namespace] <String>]
   [-WcfRelay] <String>
   [-Name] <String>
   [-Confirm]
   -Rights <String[]>
   [-WhatIf]
   [<CommonParameters>]

Description

The New-AzureRmRelayAuthorizationRule cmdlet creates a new authorization rule for the specified Relay entities (Namespace/WcfRelay/HybridConnection).

Examples

Example 1 - Namespace

PS C:\>New-AzureRmRelayAuthorizationRule -ResourceGroupName Default-ServiceBus-WestUS -Namespace TestNameSpace-Relay1 -Name AuthoRule1 -Rights "Listen"

Creates AuthoRule1 with Listen rights for the namespace TestNameSpace-Relay1.

Example 2 - WcfRelay

PS C:\>New-AzureRmRelayAuthorizationRule -ResourceGroupName Default-ServiceBus-WestUS -Namespace TestNameSpace-Relay1 -WcfRelay TestWCFRelay1 -Name AuthoRule1 -Rights "Listen"

Creates authorization rule AuthoRule1 with Listen rights for the WcfRelay TestWCFRelay1.

Example 3 - HybridConnection

PS C:\>New-AzureRmRelayAuthorizationRule -ResourceGroupName Default-ServiceBus-WestUS -Namespace TestNameSpace-Relay1 -HybridConnection TestHybridConnection -Name AuthoRule1 -Rights "Listen"

Creates AuthoRule1 with Listen rights for the namespace TestNameSpace-Relay1.

Required Parameters

-HybridConnection

HybridConnection Name.

Type:String
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

AuthorizationRule Name.

Type:String
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Namespace

Namespace Name.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ResourceGroupName

Resource Group Name.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Rights

Rights, e.g. "Listen","Send","Manage"

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-WcfRelay

WcfRelay Name.

Type:String
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

-ResourceGroupName

System.String

Inputs

-Namespace

System.String

Inputs

-WcfRelay

System.String

Inputs

-HybridConnection

System.String

Inputs

-Name

System.String

Inputs

-Rights

System.String []

Outputs

Microsoft.Azure.Commands.Relay.Models.AuthorizationRuleAttributes

Outputs

Example 1 - Namespace

Rights : {Listen} Name : AuthoRule1 Type : Microsoft.Relay/AuthorizationRules Id : /subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-WestUS/providers/Microsoft.Relay/namespaces/TestNameSpace-Relay1/AuthorizationRules/AuthoRule1

Outputs

Example 2 - WcfRelay

Rights : {Listen} Name : AuthoRule1 Type : Microsoft.Relay/AuthorizationRules Id : /subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-WestUS/providers/Microsoft.Relay/namespaces/TestNameSpace-Relay1/WcfRelays/TestWCFRelay1/authorizationRules/AuthoRule1

Outputs

Example 3 - HybridConnection

Rights : {Listen} Name : AuthoRule1 Type : Microsoft.Relay/AuthorizationRules Id : /subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-WestUS/providers/Microsoft.Relay/namespaces/TestNameSpace-Relay1/HybridConnections/TestHybridConnection/authorizationRules/AuthoRule1