Get-AzManagementGroupDeploymentWhatIfResult
Mendapatkan templat hasil What-If untuk penyebaran di cakupan grup manajemen.
Sintaks
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Deskripsi
Cmdlet Get-AzManagementGroupDeploymentWhatIfResult mendapatkan hasil What-If templat ARM untuk penyebaran templat pada cakupan grup manajemen yang ditentukan. Ini mengembalikan daftar perubahan yang menunjukkan sumber daya apa yang akan diperbarui jika penyebaran diterapkan tanpa membuat perubahan apa pun pada sumber daya nyata. Untuk menentukan format untuk hasil yang dikembalikan, gunakan parameter ResultFormat .
Contoh
Contoh 1: Dapatkan hasil What-If pada cakupan grup manajemen
Get-AzManagementGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-Location "West US" `
-ManagementGroupId "myManagementGroup" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "FullResourcePayloads"
Perintah ini mendapatkan hasil What-If pada cakupan grup manajemen dengan menggunakan file templat kustom dan file parameter pada disk. Perintah menggunakan parameter Lokasi untuk menentukan tempat menyimpan data penyebaran. Perintah menggunakan parameter ManagementGroupId untuk menentukan grup manajemen tempat templat akan disebarkan. Perintah menggunakan parameter TemplateFile untuk menentukan file templat. Perintah menggunakan parameter TemplateParameterFile untuk menentukan file parameter templat. Perintah menggunakan parameter ResultFormat untuk mengatur hasil What-If untuk menyertakan payload sumber daya penuh.
Contoh 2: Mendapatkan hasil What-If pada cakupan grup manajemen dengan ResourceIdOnly
Get-AzManagementGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-Location "West US" `
-ManagementGroupId "myManagementGroup" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "ResourceIdOnly"
Perintah ini mendapatkan hasil What-If pada cakupan grup manajemen dengan menggunakan file templat kustom dan file parameter pada disk. Perintah menggunakan parameter Lokasi untuk menentukan tempat menyimpan data penyebaran. Perintah menggunakan parameter ManagementGroupId untuk menentukan grup manajemen tempat templat akan disebarkan. Perintah menggunakan parameter TemplateFile untuk menentukan file templat. Perintah menggunakan parameter TemplateParameterFile untuk menentukan file parameter templat. Perintah menggunakan parameter ResultFormat untuk mengatur hasil What-If agar hanya berisi ID sumber daya.
Contoh 3: Gunakan file .bicepparam untuk menghitung Bagaimana-Jika
Get-AzManagementGroupDeploymentWhatIfResult -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"
Perintah ini mendapatkan hasil What-If pada cakupan grup manajemen dengan menggunakan file .bicepparam pada disk. Perintah menggunakan parameter TemplateParameterFile untuk menentukan file .bicepparam.
Parameter
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
Jenis: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ExcludeChangeType
Daftar jenis perubahan sumber daya yang dipisahkan koma yang akan dikecualikan dari hasil What-If.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Location
Lokasi untuk menyimpan data penyebaran.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ManagementGroupId
ID grup manajemen.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Name
Nama penyebaran yang akan dibuatnya. Jika tidak ditentukan, default ke nama file templat saat file templat disediakan; default ke waktu saat ini ketika objek templat disediakan, misalnya "20131223140835".
Jenis: | String |
Alias: | DeploymentName |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Pre
Saat diatur, menunjukkan bahwa cmdlet harus menggunakan versi API pra-rilis saat secara otomatis menentukan versi mana yang akan digunakan.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ResultFormat
Format hasil What-If.
Jenis: | WhatIfResultFormat |
Nilai yang diterima: | ResourceIdOnly, FullResourcePayloads |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SkipTemplateParameterPrompt
Lewati pemrosesan parameter dinamis PowerShell yang memeriksa apakah parameter templat yang disediakan berisi semua parameter yang diperlukan yang digunakan oleh templat. Pemeriksaan ini akan meminta pengguna untuk memberikan nilai untuk parameter yang hilang, tetapi menyediakan -SkipTemplateParameterPrompt akan segera mengabaikan perintah dan kesalahan ini jika parameter ditemukan tidak terikat dalam templat. Untuk skrip non-interaktif, -SkipTemplateParameterPrompt dapat disediakan untuk memberikan pesan kesalahan yang lebih baik jika tidak semua parameter yang diperlukan terpenuhi.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TemplateFile
Jalur lokal ke file templat. Jenis file templat yang didukung: json dan bicep.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-TemplateObject
Tabel hash yang mewakili templat.
Jenis: | Hashtable |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-TemplateParameterFile
File parameter yang akan digunakan untuk templat.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-TemplateParameterObject
Tabel hash yang mewakili parameter.
Jenis: | Hashtable |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-TemplateParameterUri
Uri ke file parameter templat.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-TemplateSpecId
ID sumber daya templatSpec yang akan disebarkan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-TemplateUri
Uri ke file templat.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |