New-AzResourceGroup
Cria um grupo de recursos do Azure.
Sintaxe
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 a serem adicionados 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, banco de dados ou 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 que ele atribui 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 tag é chamada de 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 compatível com o provedor de recursos. Você pode especificar uma versão diferente da versão padrão.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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-AzResourceProvider com o parâmetro ProviderNamespace .
| Tipo: | String |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Name
Especifica um nome para o grupo de recursos. O nome do recurso deve ser exclusivo na assinatura. Se um grupo de recursos com esse nome já existir, o comando solicitará a confirmação antes de substituir o grupo de recursos existente.
| Tipo: | String |
| Aliases: | ResourceGroupName |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Tag
Pares de chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="value2"} Para adicionar ou alterar uma tag, você deve substituir a coleção de tags do 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 tags para categorizar seus recursos, como por departamento ou centro de custo, ou para rastrear anotações ou comentários sobre os recursos. Para obter suas marcas predefinidas, use o cmdlet Get-AzTag.
| Tipo: | Hashtable |
| Aliases: | Tags |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |