New-AzResource
Sintaxe
ByResourceId (Padrã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>]
Descrição
O cmdlet New-AzResource cria um recurso do Azure, como um site, servidor do Banco de Dados SQL do Azure ou Banco de Dados SQL do Azure, em um grupo de recursos.
Exemplos
Exemplo 1: Criar um recurso
New-AzResource -Location "West US" -Properties @{test="test"} -ResourceName TestSite06 -ResourceType microsoft.web/sites -ResourceGroupName ResourceGroup11 -Force
Este comando cria um recurso que é um site em ResourceGroup11.
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
Este comando cria um recurso que é um site em ResourceGroup11.
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
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: False Suporta curingas: False DontShow: False Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-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 servidor nome do banco de dados
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
BySubscriptionLevel
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
ByTenantLevel
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-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 dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
BySubscriptionLevel
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
ByTenantLevel
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-IsFullObject
Indica que o objeto especificado pelo parâmetro Properties é o objeto completo.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Kind
Especifica o tipo de recurso para o recurso.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-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
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-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
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Plan
Uma tabela de hash que representa as propriedades do plano de recursos.
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: PlanObject
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-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
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-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
Tipo: PSObject
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: PropertyObject
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-ResourceGroupName
Especifica o nome do grupo de recursos onde esse cmdlet cria o recurso.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
BySubscriptionLevel
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-ResourceId
Especifica a ID de recurso totalmente qualificada, incluindo a assinatura, como no exemplo a seguir: /subscriptions/ID da assinatura/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Id
Conjuntos de parâmetros
ByResourceId
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-ResourceName
Especifica o nome do recurso. Por exemplo, para especificar um banco de dados, use o seguinte formato: ContosoServer/ContosoDatabase
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Nome
Conjuntos de parâmetros
BySubscriptionLevel
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
ByTenantLevel
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-ResourceType
Especifica o tipo do recurso.
Por exemplo, para um banco de dados, o tipo de recurso é o seguinte: Microsoft.Sql/Servers/Databases
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
BySubscriptionLevel
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
ByTenantLevel
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Sku
Uma tabela de hash que representa propriedades de sku.
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: SkuObject
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Tag
Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Etiquetas
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-TenantLevel
Indica que esse cmdlet opera no nível do locatário.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
ByTenantLevel
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: False Suporta curingas: False DontShow: False Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
