Partilhar via

New-AzureRmResourceGroup

  • Referência
Módulo:
AzureRM.Resources

Cria um grupo de recursos do Azure.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet New-AzureRmResourceGroup 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-AzureRmResource para criar recursos a serem adicionados ao grupo de recursos. Para adicionar uma implantação a um grupo de recursos existente, use o cmdlet New-AzureRmResourceGroupDeployment. Para adicionar um recurso a um grupo de recursos existente, use o cmdlet New-AzureRmResource . Um recurso do Azure é uma entidade do Azure gerenciada pelo usuário, como um servidor de banco de dados, banco de dados ou site. Um grupo de recursos do Azure é uma coleção de recursos do Azure que são implantados como uma unidade.

Exemplos

Exemplo 1: Criar um grupo de recursos vazio

PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"

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

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

PS> New-AzureRmResourceGroup RG01 "South Central US"

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

Exemplo 3: Criar um grupo de recursos com tags

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

Este comando cria um grupo de recursos vazio. Este comando é o mesmo que o comando no Exemplo 1, exceto que ele atribui tags ao grupo de recursos. A primeira tag, chamada Empty, pode ser usada para identificar grupos de recursos que não têm recursos. A segunda tag chama-se Departamento e tem um valor de Marketing. Você pode usar uma tag como esta para categorizar grupos de recursos para administração ou orçamento.

Parâmetros

-ApiVersion

Especifica a versão da API suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 da 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-AzureRmResourceProvider com o parâmetro ProviderNamespace .

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:String
Aliases:ResourceGroupName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tag

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

Tipo:Hashtable
Aliases:Tags
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup