New-AzResource

Syntax

ByResourceId (Default)

New-AzResource
 -ResourceId <String>
 [-Location <String>]
 [-Kind <String>]
 [-Properties <PSObject>]
 [-Plan <Hashtable>]
 [-Sku <Hashtable>]
 [-Tag <Hashtable>]
 [-IsFullObject]
 [-AsJob]
 [-ODataQuery <String>]
 [-Force]
 [-ApiVersion <String>]
 [-Pre]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

BySubscriptionLevel

New-AzResource
 -ResourceName <String>
 -ResourceType <String>
 [-Location <String>]
 [-Kind <String>]
 [-Properties <PSObject>]
 [-Plan <Hashtable>]
 [-Sku <Hashtable>]
 [-Tag <Hashtable>]
 [-IsFullObject]
 [-AsJob]
 [-ExtensionResourceName <String>]
 [-ExtensionResourceType <String>]
 [-ODataQuery <String>]
 [-ResourceGroupName <String>]
 [-Force]
 [-ApiVersion <String>]
 [-Pre]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

ByTenantLevel

New-AzResource
 -ResourceName <String>
 -ResourceType <String>
 [-Location <String>]
 [-Kind <String>]
 [-Properties <PSObject>]
 [-Plan <Hashtable>]
 [-Sku <Hashtable>]
 [-Tag <Hashtable>]
 [-IsFullObject]
 [-AsJob]
 [-ExtensionResourceName <String>]
 [-ExtensionResourceType <String>]
 [-ODataQuery <String>]
 [-TenantLevel]
 [-Force]
 [-ApiVersion <String>]
 [-Pre]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Description

Examples

Example 1: Create a resource

New-AzResource -Location "West US" -Properties @{test="test"} -ResourceName TestSite06 -ResourceType microsoft.web/sites -ResourceGroupName ResourceGroup11 -Force

Example 2: Create a resource using splatting

$prop = @{
 Location = "West US"
 Properties = @{test = "test"}
 ResourceName = "TestSite06"
 ResourceType = "microsoft.web/sites"
 ResourceGroupName = "ResourceGroup11"
 Force = $true
}

New-AzResource @prop

Parameters

-ApiVersion

Specifies the version of the resource provider API to use. If you do not specify a version, this cmdlet uses the latest available version.

Parameter properties

Parameter sets

-AsJob

Run cmdlet in the background

Parameter properties

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Parameter sets

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure

Parameter properties

Parameter sets

-ExtensionResourceName

Specifies the name of an extension resource for the resource. For instance, to specify a database, use the following format: server name/database name

Parameter properties

Parameter sets

-ExtensionResourceType

Specifies the resource type for an extension resource. For instance, if the extension resource is a database, specify the following type: Microsoft.Sql/Servers/Databases

Parameter properties

Parameter sets

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Parameter sets

-IsFullObject

Indicates that the object that the Properties parameter specifies is the full object.

Parameter properties

Parameter sets

-Kind

Specifies the resource kind for the resource.

Parameter properties

Parameter sets

-Location

Specifies the location of the resource. Specify data center location, such as Central US or Southeast Asia. You can place a resource in any location that supports resources of that type. Resource groups can contain resources from different locations. To determine which locations support each resource type, use the Get-AzLocation cmdlet.

Parameter properties

Parameter sets

-ODataQuery

Specifies an Open Data Protocol (OData) style filter. This cmdlet appends this value to the request in addition to any other filters.

Parameter properties

Parameter sets

-Plan

A hash table that represents resource plan properties.

Parameter properties

Parameter sets

-Pre

Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.

Parameter properties

Parameter sets

-Properties

Specifies resource properties for the resource. Use this parameter to specify the values of properties that are specific to a resource type.

Parameter properties

Parameter sets

-ResourceGroupName

Specifies the name of the resource group where this cmdlet creates the resource.

Parameter properties

Parameter sets

-ResourceId

Specifies the fully qualified resource ID, including the subscription, as in the following example: /subscriptions/subscription ID/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Parameter properties

Parameter sets

-ResourceName

Specifies the name of the resource. For instance, to specify a database, use the following format: ContosoServer/ContosoDatabase

Parameter properties

Parameter sets

-ResourceType

Specifies the type of the resource. For instance, for a database, the resource type is as follows: Microsoft.Sql/Servers/Databases

Parameter properties

Parameter sets

-Sku

A hash table that represents sku properties.

Parameter properties

Parameter sets

-Tag

Key-value pairs in the form of a hash table. For example: @{key0="value0";key1=$null;key2="value2"}

Parameter properties

Parameter sets

-TenantLevel

Indicates that this cmdlet operates at the tenant level.

Parameter properties

Parameter sets

-WhatIf

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

Parameter properties

Parameter sets

CommonParameters

Inputs

Hashtable

String

Outputs

PSObject

Related Links

• Get-AzResource
• Move-AzResource
• Remove-AzResource
• Set-AzResource