New-AzureRmResourceGroup
Crea un grupo de recursos de Azure.
Advertencia
El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Sintaxis
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-AzureRmResourceGroup 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-AzureRmResource para crear recursos que se van a agregar al grupo de recursos. Para agregar una implementación a un grupo de recursos existente, use el cmdlet New-AzureRmResourceGroupDeployment. Para agregar un recurso a un grupo de recursos existente, use el cmdlet New-AzureRmResource . 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
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"
Este comando crea un grupo de recursos que no tiene recursos. Puede usar los cmdlets New-AzureRmResource o New-AzureRmResourceGroupDeployment 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
PS> New-AzureRmResourceGroup 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
PS> New-AzureRmResourceGroup -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: | 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-AzureRmResourceProvider con el parámetro ProviderNamespace .
Tipo: | String |
Posición: | Named |
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: | Named |
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-AzureRmResource y Get-AzureRmResourceGroup para buscar recursos y grupos por nombre y 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-AzureRMTag.
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
None
Salidas
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup