Compartilhar via

New-AzResourceGroup

Módulo:
Az.Resources Module

Cria um grupo de recursos do Azure.

Sintaxe

Default (Padrão) 

New-AzResourceGroup
    [-Name] <String>
    [-Location] <String>
    [-Tag <Hashtable>]
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet New-AzResourceGroup cria um grupo de recursos do Azure. Você pode criar um grupo de recursos usando apenas um nome e um local e, em seguida, usar o cmdlet New-AzResource para criar recursos para adicionar ao grupo de recursos. Para adicionar uma implantação a um grupo de recursos existente, use o cmdlet New-AzResourceGroupDeployment. Para adicionar um recurso a um grupo de recursos existente, use o cmdlet New-AzResource . Um recurso do Azure é uma entidade do Azure gerenciada pelo usuário, como um servidor de banco de dados, um banco de dados ou um site. Um grupo de recursos do Azure é uma coleção de recursos do Azure implantados como uma unidade.

Exemplos

Exemplo 1: Criar um grupo de recursos vazio

New-AzResourceGroup -Name RG01 -Location "South Central US"

Esse comando cria um grupo de recursos que não tem recursos. Você pode usar os cmdlets New-AzResource ou New-AzResourceGroupDeployment para adicionar recursos e implantações a esse grupo de recursos.

Exemplo 2: criar um grupo de recursos vazio usando parâmetros posicionais

New-AzResourceGroup RG01 "South Central US"

Esse comando cria um grupo de recursos que não tem recursos.

Exemplo 3: Criar um grupo de recursos com marcas

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

Esse comando cria um grupo de recursos vazio. Esse comando é o mesmo que o comando no Exemplo 1, exceto pelo fato de atribuir marcas ao grupo de recursos. A primeira marca, chamada Empty, pode ser usada para identificar grupos de recursos que não têm recursos. A segunda marca é denominada Departamento e tem um valor de Marketing. Você pode usar uma marca como esta para categorizar grupos de recursos para administração ou orçamento.

Parâmetros

-ApiVersion

Especifica a versão da API com suporte do provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo 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 do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Location

Especifica o local do grupo de recursos. Especifique um local de data center do Azure, como Oeste dos EUA ou Sudeste Asiático. Você pode colocar um grupo de recursos em qualquer local. O grupo de recursos não precisa estar no mesmo local que sua assinatura do Azure ou no mesmo local que seus recursos. Para determinar qual local dá suporte a cada tipo de recurso, use o cmdlet Get-AzResourceProvider com o parâmetro ProviderNamespace .

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica um nome para o grupo de recursos. O nome do recurso deve ser exclusivo na assinatura. Se já existir um grupo de recursos com esse nome, o comando solicitará a confirmação antes de substituir o grupo de recursos existente.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NomeDoGrupoDeRecursos

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
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 do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Tag

Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; key1=$null; key2="value2"} Para adicionar ou alterar uma marca, você deve substituir a coleção de marcas para o grupo de recursos. Depois de atribuir marcas a recursos e grupos, você pode usar o parâmetro Tag de Get-AzResource e Get-AzResourceGroup para pesquisar recursos e grupos por nome de marca ou por nome e valor. Você pode usar marcas para categorizar seus recursos, como por departamento ou centro de custos, ou para acompanhar anotações ou comentários sobre os recursos. Para obter suas marcas predefinidas, use o cmdlet Get-AzTag.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Etiquetas

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo 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.

Entradas

String

Hashtable

Saídas

PSResourceGroup