New-AzResource

Sintassi

ByResourceId (Impostazione predefinita)

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

Descrizione

Esempio

Esempio 1: Creare una risorsa

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

Esempio 2: Creare una risorsa con splatting

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

New-AzResource @prop

Parametri

-ApiVersion

Specifica la versione dell'API del provider di risorse da usare. Se non si specifica una versione, questo cmdlet usa la versione più recente disponibile.

Proprietà dei parametri

Set di parametri

-AsJob

Eseguire il cmdlet in background

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Proprietà dei parametri

Set di parametri

-ExtensionResourceName

Specifica il nome di una risorsa di estensione per la risorsa. Ad esempio, per specificare un database, usare il formato seguente: nome del database del nome/del server

Proprietà dei parametri

Set di parametri

-ExtensionResourceType

Specifica il tipo di risorsa per una risorsa di estensione. Ad esempio, se la risorsa di estensione è un database, specificare il tipo seguente: Microsoft.Sql/Servers/Databases

Proprietà dei parametri

Set di parametri

-Force

Forza l'esecuzione del comando senza chiedere conferma dell'utente.

Proprietà dei parametri

Set di parametri

-IsFullObject

Indica che l'oggetto specificato dal parametro Properties è l'oggetto completo.

Proprietà dei parametri

Set di parametri

-Kind

Specifica il tipo di risorsa per la risorsa.

Proprietà dei parametri

Set di parametri

-Location

Specifica la posizione della risorsa. Specificare la posizione del data center, ad esempio Stati Uniti centrali o Asia sud-orientale. È possibile inserire una risorsa in qualsiasi posizione che supporti le risorse di quel tipo. I gruppi di risorse possono contenere risorse da posizioni diverse. Per determinare quali posizioni supportano ogni tipo di risorsa, usare il cmdlet Get-AzLocation.

Proprietà dei parametri

Set di parametri

-ODataQuery

Specifica un filtro di stile OData (Open Data Protocol). Questo cmdlet aggiunge questo valore alla richiesta oltre a qualsiasi altro filtro.

Proprietà dei parametri

Set di parametri

-Plan

Tabella hash che rappresenta le proprietà del piano di risorse.

Proprietà dei parametri

Set di parametri

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

Proprietà dei parametri

Set di parametri

-Properties

Specifica le proprietà delle risorse per la risorsa. Usare questo parametro per specificare i valori delle proprietà specifiche di un tipo di risorsa.

Proprietà dei parametri

Set di parametri

-ResourceGroupName

Specifica il nome del gruppo di risorse in cui questo cmdlet crea la risorsa.

Proprietà dei parametri

Set di parametri

-ResourceId

Specifica l'ID risorsa completo, inclusa la sottoscrizione, come nell'esempio seguente: /subscriptions/ID sottoscrizione/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Proprietà dei parametri

Set di parametri

-ResourceName

Specifica il nome della risorsa. Ad esempio, per specificare un database, usare il formato seguente: ContosoServer/ContosoDatabase

Proprietà dei parametri

Set di parametri

-ResourceType

Specifica il tipo della risorsa. Ad esempio, per un database, il tipo di risorsa è il seguente: Microsoft.Sql/Servers/Databases

Proprietà dei parametri

Set di parametri

-Sku

Tabella hash che rappresenta le proprietà dello SKU.

Proprietà dei parametri

Set di parametri

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Proprietà dei parametri

Set di parametri

-TenantLevel

Indica che questo cmdlet opera a livello di tenant.

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

CommonParameters

Input

Hashtable

String

Output

PSObject

Collegamenti correlati

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