New-AzCognitiveServicesAccount

Module:

Az.CognitiveServices

Creates a Cognitive Services account.

Syntax

New-AzCognitiveServicesAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Type] <String>
   [-SkuName] <String>
   [-Location] <String>
   [-Tag <Hashtable[]>]
   [-CustomSubdomainName <String>]
   [-AssignIdentity]
   [-UserAssignedIdentityId <String[]>]
   [-IdentityType <IdentityType>]
   [-StorageAccountId <String[]>]
   [-CognitiveServicesEncryption]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-PublicNetworkAccess <String>]
   [-DisableLocalAuth <Boolean>]
   [-RestrictOutboundNetworkAccess <Boolean>]
   [-AllowedFqdnList <String[]>]
   [-MultiRegionSetting <MultiRegionSettings>]
   [-ApiProperty <CognitiveServicesAccountApiProperties>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzCognitiveServicesAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Type] <String>
   [-SkuName] <String>
   [-Location] <String>
   [-Tag <Hashtable[]>]
   [-CustomSubdomainName <String>]
   [-AssignIdentity]
   [-UserAssignedIdentityId <String[]>]
   [-IdentityType <IdentityType>]
   [-StorageAccountId <String[]>]
   [-KeyVaultEncryption]
   -KeyName <String>
   -KeyVersion <String>
   -KeyVaultUri <String>
   [-KeyVaultIdentityClientId <String>]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-PublicNetworkAccess <String>]
   [-DisableLocalAuth <Boolean>]
   [-RestrictOutboundNetworkAccess <Boolean>]
   [-AllowedFqdnList <String[]>]
   [-MultiRegionSetting <MultiRegionSettings>]
   [-ApiProperty <CognitiveServicesAccountApiProperties>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzCognitiveServicesAccount cmdlet creates a Cognitive Services account with the specified type and SKU.

Examples

Example 1:

New-AzCognitiveServicesAccount -ResourceGroupName cognitive-services-resource-group -name myluis -Type LUIS -SkuName S0 -Location 'WestUS'

ResourceGroupName : cognitive-services-resource-group
AccountName       : myluis
Id                : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/cognitive-services-resource-group/providers/Microsoft.Cog
                    nitiveServices/accounts/myluis
Endpoint          : https://westus.api.cognitive.microsoft.com/luis/v2.0
Location          : WestUS
Sku               : Microsoft.Azure.Management.CognitiveServices.Models.Sku
AccountType       : LUIS
ResourceType      : Microsoft.CognitiveServices/accounts
Etag              : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
ProvisioningState : Succeeded
Tags              :

Parameters

-AllowedFqdnList

List of Allowed FQDN.

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

-ApiProperty

The ApiProperties of Cognitive Services Account. Required by specific account types.

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

-AssignIdentity

Generate and assign a new Cognitive Services Account Identity for this storage account for use with key management services like Azure KeyVault.

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

-CognitiveServicesEncryption

Whether to set Cognitive Services Account Encryption KeySource to Microsoft.CognitiveServices or not.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-CustomSubdomainName

Cognitive Services Account Subdomain Name.

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:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableLocalAuth

True if disable Local authentication methods.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Forces the command to run without asking for user confirmation.

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

-IdentityType

Set the new Cognitive Services Account Identity type, the idenetity is for use with key management services like Azure KeyVault.

Type:	Nullable<T>[IdentityType]
Accepted values:	None, SystemAssigned, UserAssigned, SystemAssignedUserAssigned
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyName

Cognitive Services Account encryption keySource KeyVault KeyName

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

-KeyVaultEncryption

Whether to set Cognitive Services Account encryption keySource to Microsoft.KeyVault or not. If you specify KeyName, KeyVersion and KeyVaultUri, Cognitive Services Account Encryption KeySource will also be set to Microsoft.KeyVault weather this parameter is set or not.

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

-KeyVaultIdentityClientId

Set IdentityClientId to access Azure KeyVault of Cognitive Services Account Encryption.

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

-KeyVaultUri

Cognitive Services Account encryption keySource KeyVault KeyVaultUri

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

-KeyVersion

Cognitive Services Account encryption keySource KeyVault KeyVersion

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

-Location

Specifies the location in which to create the account.

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

-MultiRegionSetting

Multi-region settings for multi-region account.

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

-Name

Specifies the name for the account.

Type:	String
Aliases:	CognitiveServicesAccountName, AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkRuleSet

NetworkRuleSet is used to define a set of configuration rules for firewalls and virtual networks, as well as to set values for network properties such as how to handle requests that don't match any of the defined rules

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

-PublicNetworkAccess

The network access type for Cognitive Services Account.

Type:	String
Accepted values:	Enabled, Disabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Specifies the name of the resource group to which to assign the account. The resource group must already exist.

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

-RestrictOutboundNetworkAccess

True if restrict outbound network access.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuName

Specifies the SKU for the account. The acceptable values for this parameter are:

• F0 (free tier)
• S0
• S1
• S2
• S3
• S4 For more information, see Cognitive Service APIs.

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

-StorageAccountId

List of User Owned Storage Accounts.

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

-Tag

Specifies a tag as a name/value pair.

Type:	Hashtable[]
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Specifies the type of account to create. Use Get-AzCognitiveServicesAccountType cmdlet to get current acceptable values.

Type:	String
Aliases:	CognitiveServicesAccountType, AccountType, Kind
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-UserAssignedIdentityId

Set resource ids for the the new Cognitive Services Account user assigned Identity, the identity will be used with key management services like Azure KeyVault.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

String

Outputs

PSCognitiveServicesAccount

Related Links

• Get-AzCognitiveServicesAccount
• Remove-AzCognitiveServicesAccount
• Set-AzCognitiveServicesAccount