Delen via

New-AzResource

  • Referentie
Module:
Az.Resources

Hiermee maakt u een resource.

Syntaxis

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

Description

Met de cmdlet New-AzResource maakt u een Azure-resource, zoals een website, Azure SQL Database-server of Azure SQL Database, in een resourcegroep.

Voorbeelden

Voorbeeld 1: Een resource maken

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

Met deze opdracht maakt u een resource die een website is in ResourceGroup11.

Voorbeeld 2: Een resource maken met behulp van splatting

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

New-AzResource @prop

Met deze opdracht maakt u een resource die een website is in ResourceGroup11.

Parameters

-ApiVersion

Hiermee geeft u de versie van de resourceprovider-API die moet worden gebruikt. Als u geen versie opgeeft, gebruikt deze cmdlet de meest recente beschikbare versie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExtensionResourceName

Hiermee geeft u de naam van een extensieresource voor de resource. Als u bijvoorbeeld een database wilt opgeven, gebruikt u de volgende indeling: servernaamdatabasenaam/

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExtensionResourceType

Hiermee geeft u het resourcetype voor een extensieresource op. Als de extensieresource bijvoorbeeld een database is, geeft u het volgende type op: Microsoft.Sql/Servers/Databases

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IsFullObject

Geeft aan dat het object dat de parameter Eigenschappen opgeeft het volledige object is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Kind

Hiermee geeft u het type resource voor de resource.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de resource. Geef de locatie van het datacenter op, zoals VS - centraal of Azië - zuidoost. U kunt een resource op elke locatie plaatsen die resources van dat type ondersteunt. Resourcegroepen kunnen resources van verschillende locaties bevatten. Gebruik de cmdlet Get-AzLocation om te bepalen welke locaties elk resourcetype ondersteunen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ODataQuery

Hiermee geeft u een OData-stijlfilter (Open Data Protocol) op. Deze cmdlet voegt deze waarde toe aan de aanvraag naast andere filters.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Plan

Een hashtabel die de eigenschappen van het resourceplan vertegenwoordigt.

Type:Hashtable
Aliassen:PlanObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Properties

Hiermee geeft u resource-eigenschappen voor de resource. Gebruik deze parameter om de waarden op te geven van eigenschappen die specifiek zijn voor een resourcetype.

Type:PSObject
Aliassen:PropertyObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waarin deze cmdlet de resource maakt.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

Hiermee geeft u de volledig gekwalificeerde resource-id op, inclusief het abonnement, zoals in het volgende voorbeeld: /subscriptions/abonnements-id/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Type:String
Aliassen:Id
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceName

Hiermee geeft u de naam van de resource. Als u bijvoorbeeld een database wilt opgeven, gebruikt u de volgende indeling: ContosoServer/ContosoDatabase

Type:String
Aliassen:Name
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceType

Hiermee geeft u het type van de resource. Voor een database is het resourcetype bijvoorbeeld als volgt: Microsoft.Sql/Servers/Databases

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Sku

Een hash-tabel die SKU-eigenschappen vertegenwoordigt.

Type:Hashtable
Aliassen:SkuObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Aliassen:Tags
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TenantLevel

Geeft aan dat deze cmdlet werkt op tenantniveau.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Hashtable

String

Uitvoerwaarden

PSObject