< Back

New-AzureRmServiceBusAuthorizationRule

Tue Jan 29, 2019 10:07 pm

NAME New-AzureRmServiceBusAuthorizationRule



SYNOPSIS

Creates a new authorization rule for the specified Service Bus given Namespace or Queue or Topic.





SYNTAX

New-AzureRmServiceBusAuthorizationRule [-ResourceGroupName] <String> [-Namespace] <String> [-Queue] <String> [-Name] <String> [-DefaultProfile

<IAzureContextContainer>] -Rights {Listen | Send | Manage} [-Confirm] [-WhatIf] [<CommonParameters>]



New-AzureRmServiceBusAuthorizationRule [-ResourceGroupName] <String> [-Namespace] <String> [-Topic] <String> [-Name] <String> [-DefaultProfile

<IAzureContextContainer>] -Rights {Listen | Send | Manage} [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The New-AzureRmServiceBusAuthorizationRule cmdlet creates a new authorization rule for the specified Service Bus namespace or queue or topic.





PARAMETERS

-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with Azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

AuthorizationRule Name



Required? true

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Namespace <String>

Namespace Name



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Queue <String>

Queue Name



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ResourceGroupName <String>

Resource Group Name



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Rights <String[]>

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



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Topic <String>

Topic Name



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String

System.String[]





OUTPUTS

Microsoft.Azure.Commands.ServiceBus.Models.PSSharedAccessAuthorizationRuleAttributes







NOTES









Example 1



PS C:\\> New-AzureRmServiceBusAuthorizationRule -ResourceGroup Default-ServiceBus-WestUS -Namespace SB-Example1 -Name AuthoRule1 -Rights

@("Listen","Send")



Creates `AuthoRule1` with Listen and Send rights for the namespace `SB-Example1`.





Example 2



PS C:\\> New-AzureRmServiceBusAuthorizationRule -ResourceGroup Default-ServiceBus-WestUS -Namespace SB-Example1 -Queue SBQueue -Name AuthoRule1

-Rights @("Listen","Send")



Creates `AuthoRule1` with Listen and Send rights for the queue `SBQueue`.





Example 3



PS C:\\> New-AzureRmServiceBusAuthorizationRule -ResourceGroup Default-ServiceBus-WestUS -Namespace SB-Example1 -Topic SBTopic -Name AuthoRule1

-Rights @("Listen","Send")



Creates `AuthoRule1` with Listen and Send rights for the topic `SBTopic`.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... zationrule