New-AzResource

Sintaxe

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

Exemplos

Exemplo 1: Criar um recurso

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

Exemplo 2: criar um recurso usando o splatting

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

New-AzResource @prop

Parâmetros

-ApiVersion

Especifica a versão da API do provedor de recursos a ser usada. Se você não especificar uma versão, esse cmdlet usará a versão mais recente disponível.

Propriedades do parâmetro

Conjuntos de parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtensionResourceName

Especifica o nome de um recurso de extensão para o recurso. Por exemplo, para especificar um banco de dados, use o seguinte formato: nome do banco de dados do nome/do servidor

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtensionResourceType

Especifica o tipo de recurso para um recurso de extensão. Por exemplo, se o recurso de extensão for um banco de dados, especifique o seguinte tipo: Microsoft.Sql/Servers/Databases

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-IsFullObject

Indica que o objeto especificado pelo parâmetro Properties é o objeto completo.

Propriedades do parâmetro

Conjuntos de parâmetros

-Kind

Especifica o tipo de recurso para o recurso.

Propriedades do parâmetro

Conjuntos de parâmetros

-Location

Especifica o local do recurso. Especifique o local do data center, como eua central ou sudeste da Ásia. Você pode colocar um recurso em qualquer local que dê suporte a recursos desse tipo. Os grupos de recursos podem conter recursos de locais diferentes. Para determinar quais locais dão suporte a cada tipo de recurso, use o cmdlet Get-AzLocation.

Propriedades do parâmetro

Conjuntos de parâmetros

-ODataQuery

Especifica um filtro de estilo OData (Open Data Protocol). Esse cmdlet acrescenta esse valor à solicitação, além de outros filtros.

Propriedades do parâmetro

Conjuntos de parâmetros

-Plan

Uma tabela de hash que representa as propriedades do plano de recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

Propriedades do parâmetro

Conjuntos de parâmetros

-Properties

Especifica as propriedades do recurso. Use esse parâmetro para especificar os valores das propriedades que são específicas para um tipo de recurso.

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

Especifica o nome do grupo de recursos em que esse cmdlet cria o recurso.

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceId

Especifica a ID de recurso totalmente qualificada, incluindo a assinatura, como no exemplo a seguir: /subscriptions/subscription ID/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceName

Especifica o nome do recurso. Por exemplo, para especificar um banco de dados, use o seguinte formato: ContosoServer/ContosoDatabase

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceType

Especifica o tipo do recurso. Por exemplo, para um banco de dados, o tipo de recurso é o seguinte: Microsoft.Sql/Servers/Databases

Propriedades do parâmetro

Conjuntos de parâmetros

-Sku

Uma tabela de hash que representa as propriedades de sku.

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; key1=$null; key2="value2"}

Propriedades do parâmetro

Conjuntos de parâmetros

-TenantLevel

Indica que esse cmdlet opera no nível do locatário.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

Hashtable

String

Saídas

PSObject

Links Relacionados

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