New-AzResourceGroup

Crea un grupo de recursos de Azure.

Syntax

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

Description

El cmdlet New-AzResourceGroup crea un grupo de recursos de Azure. Puede crear un grupo de recursos con solo un nombre y una ubicación y, a continuación, usar el cmdlet New-AzResource para crear recursos que se agreguen al grupo de recursos. Para agregar una implementación a un grupo de recursos existente, use el cmdlet New-AzResourceGroupDeployment. Para agregar un recurso a un grupo de recursos existente, use el cmdlet New-AzResource . Un recurso de Azure es una entidad de Azure administrada por el usuario, como un servidor de bases de datos, una base de datos o un sitio web. Un grupo de recursos de Azure es una colección de recursos de Azure que se implementan como una unidad.

Ejemplos

Ejemplo 1: Creación de un grupo de recursos vacío

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

Este comando crea un grupo de recursos que no tiene recursos. Puede usar los cmdlets New-AzResource o New-AzResourceGroupDeployment para agregar recursos e implementaciones a este grupo de recursos.

Ejemplo 2: Creación de un grupo de recursos vacío mediante parámetros posicionales

New-AzResourceGroup RG01 "South Central US"

Este comando crea un grupo de recursos que no tiene recursos.

Ejemplo 3: Creación de un grupo de recursos con etiquetas

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

Este comando crea un grupo de recursos vacío. Este comando es el mismo que el comando del ejemplo 1, salvo que asigna etiquetas al grupo de recursos. La primera etiqueta, denominada Empty, se puede usar para identificar grupos de recursos que no tienen recursos. La segunda etiqueta se denomina Departamento y tiene un valor de Marketing. Puede usar una etiqueta como esta para clasificar grupos de recursos para la administración o el presupuesto.

Parámetros

-ApiVersion

Especifica la versión de API compatible con el proveedor de recursos. Puede especificar una versión diferente de la versión predeterminada.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Especifica la ubicación del grupo de recursos. Especifique una ubicación de centro de datos de Azure, por ejemplo, Oeste de EE. UU. o Sudeste de Asia. Puede colocar un grupo de recursos en cualquier ubicación. El grupo de recursos no tiene que estar en la misma ubicación que la suscripción de Azure o en la misma ubicación que sus recursos. Para determinar qué ubicación admite cada tipo de recurso, use el cmdlet Get-AzResourceProvider con el parámetro ProviderNamespace .

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica un nombre para el grupo de recursos. El nombre del recurso debe ser único en la suscripción. Si ya existe un grupo de recursos que tiene ese nombre, el sistema le pedirá confirmación antes de reemplazar el grupo de recursos existente.

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Indica que este cmdlet considera las versiones de API de versión preliminar cuando determina automáticamente qué versión se va a usar.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"} Para agregar o cambiar una etiqueta, debe reemplazar la colección de etiquetas para el grupo de recursos. Después de asignar etiquetas a recursos y grupos, puede usar el parámetro Tag de Get-AzResource y Get-AzResourceGroup para buscar recursos y grupos por nombre de etiqueta o por nombre y valor. Puede usar etiquetas para clasificar los recursos, como por departamento o centro de costos, o para realizar un seguimiento de notas o comentarios sobre los recursos. Para obtener las etiquetas predefinidas, use el cmdlet Get-AzTag.

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Hashtable

Salidas

PSResourceGroup