New-AzBotService

Returns a BotService specified by the parameters.

Syntax

New-AzBotService
   -ResourceGroupName <String>
   -ApplicationId <String>
   [-Name <String>]
   [-DisplayName <String>]
   [-Endpoint <String>]
   [-Description <String>]
   [-Registration]
   [-Location <String>]
   [-ServerFarmLocation <String>]
   [-Language <String>]
   [-BotTemplateType <String>]
   [-SubscriptionId <String[]>]
   -Sku <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
New-AzBotService
   -ResourceGroupName <String>
   -ApplicationId <String>
   [-Name <String>]
   [-Description <String>]
   [-Location <String>]
   [-ServerFarmLocation <String>]
   [-Language <String>]
   [-BotTemplateType <String>]
   [-SubscriptionId <String[]>]
   -ApplicationSecret <SecureString>
   [-Webapp]
   [-ExistingServerFarmId <String>]
   -Sku <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

Returns a BotService specified by the parameters.

Examples

Example 1: Create a new bot

New-AzBotService -resourcegroupname BotTest-rg -name BotTest1 -ApplicationId "af5fce4d-ee68-4b25-be09-f3222582e133" -Location global -Sku F0 -Description "123134" -Registration

Etag                                   Kind Location Name     SkuName SkuTier Zone
----                                   ---- -------- ----     ------- ------- ----
"060085fb-0000-1800-0000-5fd71d7c0000" bot  global   BotTest1 F0              {}

Create a new Bot by ResourceGroupName and ApplicationId

Example 2: Create a new Web App

New-AzBotService -resourcegroupname BotTest-rg -name BotTest2 -ApplicationId "b1ab1727-0465-4255-a1bb-976210af972c" -Location global -Sku F0 -Description "123134" -Webapp

Etag                                   Kind Location Name     SkuName SkuTier Zone
----                                   ---- -------- ----     ------- ------- ----
"06008351-0000-0200-0000-5fd732870000" sdk  global   BotTest2 F0              {}

Create a new Web App by ResourceGroupName and ApplicationId

Parameters

-ApplicationId

Microsoft App Id for the bot

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

-ApplicationSecret

Microsoft App secret generated by the corresponding Add Id

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BotTemplateType

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

-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

The description of the bot

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

-DisplayName

DisplayName can be different from the bot Name.

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

-Endpoint

The bot's endpoint

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

-ExistingServerFarmId

Provide this if required ServerFarm has been created.

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

-Language

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

-Location

Specifies the location of the resource.

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

-Name

The name of the Bot resource.

Type:String
Aliases:BotName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Registration

Default kind of a bot.

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

-ResourceGroupName

The name of the Bot resource group in the user subscription.

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

-ServerFarmLocation

Specifies the location of the server farm.

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

-Sku

The sku name

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

-SubscriptionId

Azure Subscription ID.

Type:String[]
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Webapp

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

Outputs

IBot