New-AzResourceGroupDeployment
Azure-telepítést ad hozzá egy erőforráscsoporthoz.
Syntax
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-Force]
[-ProceedIfNoChange]
[-AsJob]
[-AuxTenant <String[]>]
[-QueryString <String>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A New-AzResourceGroupDeployment parancsmag üzembe helyezést ad hozzá egy meglévő erőforráscsoporthoz. 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, például adatbázis-kiszolgáló, adatbázis, webhely, virtuális gép vagy Storage-fiók. Az Azure-erőforráscsoportok olyan Azure-erőforrások gyűjteményei, amelyek egységként vannak üzembe helyezve, például a webhely, az adatbázis-kiszolgáló és a pénzügyi webhelyekhez szükséges adatbázisok. Az erőforráscsoportok üzembe helyezése sablonnal adja hozzá az erőforrásokat egy erőforráscsoporthoz, és közzéteszi őket, hogy elérhetők legyenek az Azure-ban. Ha sablon használata nélkül szeretne erőforrásokat hozzáadni egy erőforráscsoporthoz, használja a New-AzResource parancsmagot. Erőforráscsoport-telepítés hozzáadásához adja meg egy meglévő erőforráscsoport és egy erőforráscsoport-sablon nevét. Az erőforráscsoport-sablon egy olyan JSON-sztring, amely egy összetett felhőalapú szolgáltatás, például egy webportál erőforráscsoportját jelöli. 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. Számos sablont találhat az Azure-sablongyűjteményben, vagy létrehozhat saját sablonokat. Ha egyéni sablont szeretne használni egy erőforráscsoport létrehozásához, 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-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}
Ez a parancs létrehoz egy új üzembe helyezést egy egyéni sablon és egy sablonfájl használatával a lemezen, meghatározott címkék paramé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: 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-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"
Ez a parancs létrehoz egy új üzembe helyezést egy egyéni és egy sablonfájllal 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 a kivonatolót és a TemplateParameterFile paramétert egy olyan fájl megadásához, amely paramétereket és paraméterértékeket tartalmaz.
3. példa
Azure-telepítést ad hozzá egy erőforráscsoporthoz. (automatikusan létrehozott)
New-AzResourceGroupDeployment -DeploymentDebugLogLevel RequestContent -Name mynewstorageaccount -ResourceGroupName 'ContosoEngineering' -TemplateFile 'D:\Azure\Templates\EngineeringSite.json' -TemplateParameterObject <Hashtable>
4. példa: Nem nyilvános tárfiókban tárolt sablon üzembe helyezése URI- és SAS-jogkivonat használatával
New-AzResourceGroupDeployment -ResourceGroupName "RGName" -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?foo
használatával.
Ez akkor használható, ha sablont szeretne használni egy tárfiókban úgy, hogy az SAS-jogkivonatot QueryStringként adja meg
5. példa: .bicepparam-fájl használata üzembe helyezés létrehozásához
New-AzResourceGroupDeployment -ResourceGroupName "RGName" -TemplateParameterFile "./parameters.bicepparam"
Ez a parancs létrehoz egy új üzembe helyezést az erőforráscsoport hatókörében egy .bicepparam fájllal 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 |
-AuxTenant
Aux-bérlőazonosítók bérlők közötti üzemelő példányokhoz
Típus: | String[] |
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: | False |
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
Hibakeresési naplószintet ad meg. A paraméter elfogadható értékei a következők:
- RequestContent
- ResponseContent
- Mind
- Egyik sem
Típus: | String |
Elfogadott értékek: | RequestContent, ResponseContent, All, None |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Mode
Az üzembehelyezési módot adja meg. A paraméter elfogadható értékei a következők:
- Kész: Teljes módban a Resource Manager törli az erőforráscsoportban található, de a sablonban nem megadott erőforrásokat.
- Növekményes: Növekményes módban a Resource Manager változatlan erőforrásokat hagy az erőforráscsoportban, de nincsenek megadva a sablonban.
Típus: | DeploymentMode |
Elfogadott értékek: | Incremental, Complete |
Position: | Named |
Alapértelmezett érték: | Incremental |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
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: | True |
Helyettesítő karakterek elfogadása: | False |
-Pre
Azt jelzi, hogy ez a parancsmag a kiadás előtti API-verziókat veszi figyelembe, amikor automatikusan meghatározza a használni kívánt verziót.
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 |
-ResourceGroupName
Megadja az üzembe helyezni kívánt erőforráscsoport nevét.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-RollBackDeploymentName
Ha a -RollbackToLastDeployment nevet használja, ne használja a sikeres üzembe helyezést az erőforráscsoportban megadott névvel.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-RollbackToLastDeployment
Az erőforráscsoport utolsó sikeres üzembe helyezésének visszaállítása nem lehet jelen a -RollBackDeploymentName használata esetén.
Típus: | SwitchParameter |
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
Egy egyéni sablonfájl teljes elérési útját adja meg. 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
Megadja a sablonparaméterek nevét és értékeit tartalmazó JSON-fájl teljes elérési útját. Ha egy sablon paraméterekkel rendelkezik, meg kell adnia a paraméterértékeket a TemplateParameterFile paraméterrel vagy a TemplateParameterObject paraméterrel. A sablonparaméterek dinamikusan hozzáadódnak a parancshoz egy sablon megadásakor. A dinamikus paraméterek használatához írjon be egy mínuszjelet (-) egy paraméternév jelzéséhez, majd a Tab billentyűvel lépegetjen a rendelkezésre álló paraméterek között.
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 sablonparaméterek neveit és értékeit tartalmazó kivonattáblát adja meg.
Ha segítségre van szüksége a Windows PowerShell kivonattábláival kapcsolatban, írja be a következőt Get-Help about_Hash_Tables
: .
Ha egy sablon paraméterekkel rendelkezik, paraméterértékeket kell megadnia.
A sablonparaméterek dinamikusan hozzáadódnak a parancshoz egy sablon megadásakor.
Típus: | Hashtable |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-TemplateParameterUri
Egy sablonparaméterfájl URI-ját adja meg. A TemplateParameterUri használatakor a használt dinamikus paraméterek figyelmen kívül lesznek hagyva. Dinamikus paraméterek használatához ehelyett a TemplateParameterFile paramétert kell használnia
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
Egyéni sablonfájl URI-ját adja meg.
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: | False |
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 |