New-AzDeployment
Hozzon létre egy üzembe helyezést az aktuális előfizetés hatókörében.
Syntax
New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
A New-AzDeployment parancsmag üzembe helyezést ad hozzá az aktuális előfizetés hatókörében. Ide tartoznak az üzembe helyezéshez szükséges erőforrások.
Az Azure-erőforrások felhasználó által felügyelt Azure-entitások. Az erőforrások egy erőforráscsoportban is élhetnek, például adatbázis-kiszolgáló, adatbázis, webhely, virtuális gép vagy Tárfiók. Vagy lehet előfizetési szintű erőforrás, például szerepkördefiníció, szabályzatdefiníció stb.
Ha erőforrásokat szeretne hozzáadni egy erőforráscsoporthoz, használja a New-AzResourceGroupDeployment parancsot, amely üzembe helyezést hoz létre egy erőforráscsoportban. A New-AzDeployment parancsmag létrehoz egy üzembe helyezést az aktuális előfizetési hatókörben, amely előfizetési szintű erőforrásokat helyez üzembe.
Ha üzembe helyezést szeretne hozzáadni az előfizetéshez, adja meg a helyet és a sablont. A hely megadja az Azure Resource Managernek, hogy hol tárolja az üzembehelyezési adatokat. A sablon egy JSON-sztring, amely az üzembe helyezendő erőforrásokat tartalmazza. A sablon paraméterhelyőrzőket tartalmaz a szükséges erőforrásokhoz és konfigurálható tulajdonságértékekhez, például nevekhez és méretekhez.
Ha egyéni sablont szeretne használni az üzembe helyezéshez, adja meg a TemplateFile paramétert vagy a TemplateUri paramétert. Minden sablon paraméterekkel rendelkezik a konfigurálható tulajdonságokhoz. A sablonparaméterek értékeinek megadásához adja meg a TemplateParameterFile paramétert vagy a TemplateParameterObject paramétert . Másik lehetőségként használhatja azokat a sablonparamétereket, amelyek dinamikusan hozzáadódnak a parancshoz egy sablon megadásakor. Dinamikus paraméterek használatához írja be őket a parancssorba, vagy írjon be egy mínuszjelet (-) egy paraméter jelzéséhez, és a Tab billentyűvel válthat az elérhető paraméterek között. A parancssorban megadott sablonparaméter-értékek elsőbbséget élveznek a sablonparaméter objektumában vagy fájljában lévő értékekkel szemben.
Példák
1. példa: Üzembe helyezés létrehozása egyéni sablon és paraméterfájl használatával
New-AzDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}Ez a parancs egy új üzembe helyezést hoz létre az aktuális előfizetés hatókörében egy egyéni sablon és egy sablonfájl használatával a lemezen, meghatározott címkeparaméterrel. A parancs a TemplateFile paraméterrel adja meg a sablont és a TemplateParameterFile paramétert egy olyan fájl megadásához, amely paramétereket és paraméterértékeket tartalmaz.
2. példa: Nem nyilvános tárfiókban tárolt sablon üzembe helyezése URI- és SAS-jogkivonat használatával
New-AzDeployment -Location "West US" -TemplateUri "https://example.com/example.json" -QueryString "foo"Ez a parancs létrehoz egy új üzembe helyezést a sablon használatával a TemplateUri-ban, amely nem nyilvános, és egy tokenparamétert igényel a hozzáféréshez, amelyet a QueryString paraméterrel adna meg.
A parancs futtatása hatékonyan éri el a sablont az URL-cím https://example.com/example.json?foohasználatával.
Ez akkor használható, ha sablont szeretne használni egy tárfiókban úgy, hogy az SAS-jogkivonatot QueryStringként adja meg
3. példa: Egyéni sablonobjektum és paraméterfájl használata üzembe helyezés létrehozásához
$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzDeployment -Location "West US" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"Ez a parancs létrehoz egy új üzembe helyezést az aktuális előfizetés hatókörében egy egyéni sablon és egy sablonfájl használatával a lemezen, amelyet memóriabeli kivonatolóvá alakítottak át. Az első két parancs felolvassa a lemezen lévő sablonfájl szövegét, és átalakítja memórián belüli kivonatolóvá. Az utolsó parancs a TemplateObject paraméterrel adja meg ezt a kivonatolót és a TemplateParameterFile paramétert egy olyan fájl megadásához, amely paramétereket és paraméterértékeket tartalmaz.
4. példa: .bicepparam-fájl használata üzembe helyezés létrehozásához
New-AzDeployment -Location "West US" -TemplateParameterFile "./parameters.bicepparam"Ez a parancs létrehoz egy új üzembe helyezést az aktuális előfizetés hatókörében egy .bicepparam fájl használatával a lemezen. A parancs a TemplateParameterFile paraméterrel határoz meg egy .bicepparam-fájlt.
Paraméterek
-AsJob
Parancsmag futtatása a háttérben
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
| Típus: | SwitchParameter |
| Aliasok: | cf |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
| Típus: | IAzureContextContainer |
| Aliasok: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DeploymentDebugLogLevel
Az üzembehelyezési hibakeresési napló szintje.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Location
Az üzembehelyezési adatok tárolásának helye.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Name
A létrehozni kívánt üzembe helyezés neve. Ha nincs megadva, a sablonfájl neve alapértelmezés szerint a sablonfájl megadásakor van megadva; a sablonobjektumok (például "20131223140835") megadásakor az alapértelmezett érték.
| Típus: | String |
| Aliasok: | DeploymentName |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Pre
Ha be van állítva, azt jelzi, hogy a parancsmagnak a kiadás előtti API-verziókat kell használnia, amikor automatikusan meghatározza, hogy melyik verziót használja.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ProceedIfNoChange
Ne kérjen megerősítést, ha a What-If eredmény nem változik. Akkor alkalmazható, ha a -Confirm kapcsoló be van állítva.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-QueryString
A TemplateUri paraméterrel használandó lekérdezési sztring (például SAS-jogkivonat). Csatolt sablonok esetén használható
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-SkipTemplateParameterPrompt
Kihagyja a PowerShell dinamikus paraméterfeldolgozását, amely ellenőrzi, hogy a megadott sablonparaméter tartalmazza-e a sablon által használt összes szükséges paramétert. Ez az ellenőrzés arra kéri a felhasználót, hogy adjon meg egy értéket a hiányzó paraméterekhez, de ha a -SkipTemplateParameterPrompt értéket adja meg, a rendszer azonnal figyelmen kívül hagyja ezt a kérést, és azonnal hibát jelez, ha egy paramétert nem kötött a sablon. Nem interaktív szkriptek esetén a -SkipTemplateParameterPrompt szolgáltatással jobb hibaüzenet jeleníthető meg abban az esetben, ha nem minden szükséges paraméter teljesül.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Tag
Az üzembe helyezéshez szükséges címkék.
| Típus: | Hashtable |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-TemplateFile
A sablonfájl helyi elérési útja. Támogatott sablonfájltípus: json és bicep.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-TemplateObject
A sablont jelképező kivonattábla.
| Típus: | Hashtable |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-TemplateParameterFile
A sablonhoz használandó paraméterfájl.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-TemplateParameterObject
A paramétereket képviselő kivonattábla.
| Típus: | Hashtable |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-TemplateParameterUri
Uri a sablonparaméter-fájlhoz.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-TemplateSpecId
Az üzembe helyezendő templateSpec erőforrás-azonosítója.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-TemplateUri
Uri a sablonfájlhoz.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
| Típus: | SwitchParameter |
| Aliasok: | wi |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-WhatIfExcludeChangeType
A vesszővel tagolt erőforrás-módosítási típusokat ki kell zárni a "Ha" eredményből. Akkor alkalmazható, ha a -WhatIf vagy a -Confirm kapcsoló be van állítva.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-WhatIfResultFormat
A "What-If" eredményformátum.
| Típus: | WhatIfResultFormat |
| Elfogadott értékek: | ResourceIdOnly, FullResourcePayloads |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
