< Back

New-AzureRmRelayNamespace

Tue Jan 29, 2019 10:04 pm

NAME New-AzureRmRelayNamespace



SYNOPSIS

Creates a new Relay namespace.





SYNTAX

New-AzureRmRelayNamespace [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-DefaultProfile <IAzureContextContainer>] [-Tag

<Hashtable>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The New-AzureRmRelayNamespace cmdlet creates a new Relay namespace. Once created, the namespace resource manifest is immutable.





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



-Location <String>

Relay Namespace Location.



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

Relay Namespace Name



Required? true

Position? 1

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



-Tag <Hashtable>

Key-value pairs in the form of a hash table. For example:



@{key0="value0";key1=$null;key2="value2"}



Required? false

Position? named

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

-ResourceGroupName

System.String



-NamespaceName

System.String



-Location

System.String



-SkuName

System.String



-Tag

System.Collections.Hashtable





OUTPUTS

Microsoft.Azure.Commands.Relay.Models.RelayNamespaceAttributes







NOTES









Example 1



PS C:\\> New-AzureRmRelayNamespace -ResourceGroupName Default-ServiceBus-WestUS -NamespaceName TestNameSpace-Relay1 -Location "West US" -Tag

@{Tag1="Tag1Value"}



ProvisioningState : Succeeded

CreatedAt : 4/12/2017 12:38:47 AM

UpdatedAt : 4/12/2017 12:39:10 AM

ServiceBusEndpoint : https://TestNameSpace-Relay1.servicebus ... s.net:443/

MetricId : XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:testnamespace-relay1

Location : West US

Tags : {[tag1, Tag1Value]}

Id : /subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/Default-ServiceBus-WestUS/providers/Microsoft.Relay/namespa

ces/TestNameSpace-Relay1

Name : TestNameSpace-Relay1

Type : Microsoft.Relay/namespaces



Creates a new Relay namespace within the specified resource group.







RELATED LINKS

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