New-AzResource

Sintaxe

ByResourceId (Predefinição)

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 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 dos parâmetros

Conjuntos de parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DefaultProfile

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

Propriedades dos parâmetros

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: nomedo servidor nome do banco de dados

Propriedades dos parâmetros

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:

Propriedades dos parâmetros

Conjuntos de parâmetros

-Force

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsFullObject

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Kind

Especifica o tipo de recurso para o recurso.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Location

Especifica o local do recurso. Especifique a localização do data center, como Centro dos EUA ou Sudeste Asiático. Você pode colocar um recurso em qualquer local que ofereça suporte a recursos desse tipo. Os grupos de recursos podem conter recursos de locais diferentes. Para determinar quais locais oferecem suporte a cada tipo de recurso, use o cmdlet Get-AzLocation.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ODataQuery

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Plan

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

Propriedades dos parâmetros

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 dos parâmetros

Conjuntos de parâmetros

-Properties

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceGroupName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceId

Especifica a ID de recurso totalmente qualificada, incluindo a assinatura, como no exemplo a seguir: ID da assinatura

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceType

Especifica o tipo do recurso. Por exemplo, para um banco de dados, o tipo de recurso é o seguinte:

Propriedades dos parâmetros

Conjuntos de parâmetros

-Sku

Uma tabela de hash que representa propriedades de sku.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Tag

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-TenantLevel

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

Hashtable

String

Saídas

PSObject

Ligações Relacionadas

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