New-AzResource
Skapar en resurs.
Syntax
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
Cmdleten New-AzResource skapar en Azure-resurs, till exempel en webbplats, Azure SQL Database-server eller Azure SQL Database, i en resursgrupp.
Exempel
Exempel 1: Skapa en resurs
New-AzResource -Location "West US" -Properties @{test="test"} -ResourceName TestSite06 -ResourceType microsoft.web/sites -ResourceGroupName ResourceGroup11 -Force
Det här kommandot skapar en resurs som är en webbplats i ResourceGroup11.
Exempel 2: Skapa en resurs med hjälp av splatting
$prop = @{
Location = "West US"
Properties = @{test = "test"}
ResourceName = "TestSite06"
ResourceType = "microsoft.web/sites"
ResourceGroupName = "ResourceGroup11"
Force = $true
}
New-AzResource @prop
Det här kommandot skapar en resurs som är en webbplats i ResourceGroup11.
Parametrar
-ApiVersion
Anger vilken version av resursprovider-API:et som ska användas. Om du inte anger någon version använder den här cmdleten den senaste tillgängliga versionen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Kör cmdlet i bakgrunden
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
standardvärde: | False |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionResourceName
Anger namnet på en tilläggsresurs för resursen. Om du till exempel vill ange en databas använder du följande format: databasnamn för servernamn/
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionResourceType
Anger resurstypen för en tilläggsresurs.
Om tilläggsresursen till exempel är en databas anger du följande typ: Microsoft.Sql/Servers/Databases
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsFullObject
Anger att det objekt som parametern Egenskaper anger är det fullständiga objektet.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Kind
Anger resurstypen för resursen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Anger resursens plats. Ange datacenterplats, till exempel USA, centrala eller Asien, sydöstra. Du kan placera en resurs på valfri plats som stöder resurser av den typen. Resursgrupper kan innehålla resurser från olika platser. Om du vill ta reda på vilka platser som stöder varje resurstyp använder du cmdleten Get-AzLocation.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ODataQuery
Anger ett OData-formatfilter (Open Data Protocol). Den här cmdleten lägger till det här värdet i begäran utöver andra filter.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Plan
En hash-tabell som representerar egenskaper för resursplan.
Typ: | Hashtable |
Aliases: | PlanObject |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Properties
Anger resursegenskaper för resursen. Använd den här parametern för att ange värdena för egenskaper som är specifika för en resurstyp.
Typ: | PSObject |
Aliases: | PropertyObject |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Anger namnet på resursgruppen där den här cmdleten skapar resursen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Anger det fullständigt kvalificerade resurs-ID:t, inklusive prenumerationen, som i följande exempel: /subscriptions/
prenumerations-ID/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase
Typ: | String |
Aliases: | Id |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceName
Anger namnet på resursen. Om du till exempel vill ange en databas använder du följande format: ContosoServer/ContosoDatabase
Typ: | String |
Aliases: | Name |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceType
Anger resurstypen.
För en databas är till exempel resurstypen följande: Microsoft.Sql/Servers/Databases
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Sku
En hash-tabell som representerar sku-egenskaper.
Typ: | Hashtable |
Aliases: | SkuObject |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}
Typ: | Hashtable |
Aliases: | Tags |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantLevel
Anger att den här cmdleten fungerar på klientorganisationsnivå.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
standardvärde: | False |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |