New-AzResource

Sintaxis

ByResourceId (valor predeterminado)

New-AzResource
    -ResourceId <String>
    [-Location <String>]
    [-Kind <String>]
    [-Properties <PSObject>]
    [-Plan <Hashtable>]
    [-Sku <Hashtable>]
    [-Tag <Hashtable>]
    [-IsFullObject]
    [-AsJob]
    [-ODataQuery <String>]
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BySubscriptionLevel

New-AzResource
    -ResourceName <String>
    -ResourceType <String>
    [-Location <String>]
    [-Kind <String>]
    [-Properties <PSObject>]
    [-Plan <Hashtable>]
    [-Sku <Hashtable>]
    [-Tag <Hashtable>]
    [-IsFullObject]
    [-AsJob]
    [-ExtensionResourceName <String>]
    [-ExtensionResourceType <String>]
    [-ODataQuery <String>]
    [-ResourceGroupName <String>]
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTenantLevel

New-AzResource
    -ResourceName <String>
    -ResourceType <String>
    [-Location <String>]
    [-Kind <String>]
    [-Properties <PSObject>]
    [-Plan <Hashtable>]
    [-Sku <Hashtable>]
    [-Tag <Hashtable>]
    [-IsFullObject]
    [-AsJob]
    [-ExtensionResourceName <String>]
    [-ExtensionResourceType <String>]
    [-ODataQuery <String>]
    [-TenantLevel]
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Creación de un recurso

New-AzResource -Location "West US" -Properties @{test="test"} -ResourceName TestSite06 -ResourceType microsoft.web/sites -ResourceGroupName ResourceGroup11 -Force

Ejemplo 2: Creación de un recurso mediante la expansión

$prop = @{
    Location          = "West US"
    Properties        = @{test = "test"}
    ResourceName      = "TestSite06"
    ResourceType      = "microsoft.web/sites"
    ResourceGroupName = "ResourceGroup11"
    Force             = $true
}

New-AzResource @prop

Parámetros

-ApiVersion

Especifica la versión de la API del proveedor de recursos que se va a usar. Si no especifica una versión, este cmdlet usa la versión más reciente disponible.

Propiedades de parámetro

Conjuntos de parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-DefaultProfile

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

Propiedades de parámetro

Conjuntos de parámetros

-ExtensionResourceName

Especifica el nombre de un recurso de extensión para el recurso. Por ejemplo, para especificar una base de datos, use el siguiente formato: nombre de base de datos de nombre/de servidor

Propiedades de parámetro

Conjuntos de parámetros

-ExtensionResourceType

Especifica el tipo de recurso de un recurso de extensión. Por ejemplo, si el recurso de extensión es una base de datos, especifique el tipo siguiente: Microsoft.Sql/Servers/Databases

Propiedades de parámetro

Conjuntos de parámetros

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-IsFullObject

Indica que el objeto que especifica el parámetro Properties es el objeto completo.

Propiedades de parámetro

Conjuntos de parámetros

-Kind

Especifica el tipo de recurso para el recurso.

Propiedades de parámetro

Conjuntos de parámetros

-Location

Especifica la ubicación del recurso. Especifique la ubicación del centro de datos, como Centro de EE. UU. o Sudeste asiático. Puede colocar un recurso en cualquier ubicación que admita recursos de ese tipo. Los grupos de recursos pueden contener recursos de diferentes ubicaciones. Para determinar qué ubicaciones admiten cada tipo de recurso, use el cmdlet Get-AzLocation.

Propiedades de parámetro

Conjuntos de parámetros

-ODataQuery

Especifica un filtro de estilo de Open Data Protocol (OData). Este cmdlet anexa este valor a la solicitud además de cualquier otro filtro.

Propiedades de parámetro

Conjuntos de parámetros

-Plan

Tabla hash que representa las propiedades del plan de recursos.

Propiedades de parámetro

Conjuntos de parámetros

-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.

Propiedades de parámetro

Conjuntos de parámetros

-Properties

Especifica las propiedades de los recursos para el recurso. Use este parámetro para especificar los valores de las propiedades específicas de un tipo de recurso.

Propiedades de parámetro

Conjuntos de parámetros

-ResourceGroupName

Especifica el nombre del grupo de recursos donde este cmdlet crea el recurso.

Propiedades de parámetro

Conjuntos de parámetros

-ResourceId

Especifica el identificador de recurso completo, incluida la suscripción, como en el ejemplo siguiente: identificador de suscripción. /subscriptions//providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Propiedades de parámetro

Conjuntos de parámetros

-ResourceName

Especifica el nombre del recurso. Por ejemplo, para especificar una base de datos, use el formato siguiente: ContosoServer/ContosoDatabase

Propiedades de parámetro

Conjuntos de parámetros

-ResourceType

Especifica el tipo del recurso. Por ejemplo, para una base de datos, el tipo de recurso es el siguiente: Microsoft.Sql/Servers/Databases

Propiedades de parámetro

Conjuntos de parámetros

-Sku

Tabla hash que representa las propiedades de SKU.

Propiedades de parámetro

Conjuntos de parámetros

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Propiedades de parámetro

Conjuntos de parámetros

-TenantLevel

Indica que este cmdlet funciona en el nivel de inquilino.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

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

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

Hashtable

String

Salidas

PSObject

Vínculos relacionados

• Get-AzResource
• Move-AzResource
• Remove-AzResource
• Set-AzResource