Compartir a través de


New-AzResourceGroup

Crea un grupo de recursos de Azure.

Sintaxis

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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

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

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Alias:ResourceGroupName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Hashtable
Alias:Tags
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Hashtable

Salidas

PSResourceGroup