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 |