New-AzResource
Cria um recurso.
Syntax
New-AzResource
[-Location <String>]
[-Kind <String>]
[-Properties <PSObject>]
[-Plan <Hashtable>]
[-Sku <Hashtable>]
[-Tag <Hashtable>]
[-IsFullObject]
[-AsJob]
-ResourceId <String>
[-ODataQuery <String>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResource
[-Location <String>]
[-Kind <String>]
[-Properties <PSObject>]
[-Plan <Hashtable>]
[-Sku <Hashtable>]
[-Tag <Hashtable>]
[-IsFullObject]
[-AsJob]
-ResourceName <String>
-ResourceType <String>
[-ExtensionResourceName <String>]
[-ExtensionResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResource
[-Location <String>]
[-Kind <String>]
[-Properties <PSObject>]
[-Plan <Hashtable>]
[-Sku <Hashtable>]
[-Tag <Hashtable>]
[-IsFullObject]
[-AsJob]
-ResourceName <String>
-ResourceType <String>
[-ExtensionResourceName <String>]
[-ExtensionResourceType <String>]
[-ODataQuery <String>]
[-TenantLevel]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Executar cmdlet em segundo plano
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predefinido: | False |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsFullObject
Indica que o objeto especificado pelo parâmetro Properties é o objeto completo.
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Kind
Especifica o tipo de recurso para o recurso.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ODataQuery
Especifica um filtro de estilo OData (Open Data Protocol). Este cmdlet acrescenta esse valor à solicitação, além de quaisquer outros filtros.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Plan
Uma tabela de hash que representa as propriedades do plano de recursos.
Tipo: | Hashtable |
Aliases: | PlanObject |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Properties
Especifica as propriedades do recurso. Use esse parâmetro para especificar os valores das propriedades específicas de um tipo de recurso.
Tipo: | PSObject |
Aliases: | PropertyObject |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos onde esse cmdlet cria o recurso.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
Tipo: | String |
Aliases: | Id |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceName
Especifica o nome do recurso. Por exemplo, para especificar um banco de dados, use o seguinte formato: ContosoServer/ContosoDatabase
Tipo: | String |
Aliases: | Name |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceType
Especifica o tipo do recurso.
Por exemplo, para um banco de dados, o tipo de recurso é o seguinte: Microsoft.Sql/Servers/Databases
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Sku
Uma tabela de hash que representa propriedades de sku.
Tipo: | Hashtable |
Aliases: | SkuObject |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}
Tipo: | Hashtable |
Aliases: | Tags |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantLevel
Indica que esse cmdlet opera no nível do locatário.
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predefinido: | False |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |