Get-AzResourceGroupDeploymentWhatIfResult
Obtiene un resultado what-if de plantilla para una implementación en el ámbito del grupo de recursos.
Syntax
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
El cmdlet Get-AzResourceGroupDeploymentWhatIfResult obtiene el resultado What-If de la plantilla de ARM para una implementación de plantilla en el ámbito del grupo de recursos especificado. Devuelve una lista de cambios que indican qué recursos se actualizarán si la implementación se aplica sin realizar ningún cambio en los recursos reales. Para especificar el formato del resultado devuelto, use el parámetro ResultFormat .
Ejemplos
Ejemplo 1: Obtención de un resultado what-if en el ámbito del grupo de recursos
Get-AzResourceGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-ResourceGroupName "myRG1" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "FullResourcePayloads"Este comando obtiene un resultado What-If en el ámbito del grupo de recursos especificado mediante un archivo de plantilla personalizado y un archivo de parámetros en el disco. El comando usa el parámetro ResourceGroupName para especificar un grupo de recursos donde se implementará la plantilla. El comando usa el parámetro TemplateFile para especificar un archivo de plantilla. El comando usa el parámetro TemplateParameterFile para especificar un archivo de parámetros de plantilla. El comando usa el parámetro ResultFormat para establecer el resultado What-If para incluir cargas completas de recursos.
Ejemplo 2: Obtención de un resultado what-if en el ámbito del grupo de recursos con ResourceIdOnly
Get-AzResourceGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-ResourceGroupName "myRG1" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "ResourceIdOnly"Este comando obtiene un resultado What-If en el ámbito del grupo de recursos especificado mediante un archivo de plantilla personalizado y un archivo de parámetros en el disco. El comando usa el parámetro ResourceGroupName para especificar un grupo de recursos donde se implementará la plantilla. El comando usa el parámetro TemplateFile para especificar un archivo de plantilla. El comando usa el parámetro TemplateParameterFile para especificar un archivo de parámetros de plantilla. El comando usa el parámetro ResultFormat para establecer el resultado What-If para que solo contenga identificadores de recursos.
Ejemplo 3: Usar un archivo .bicepparam para calcular what-if
Get-AzResourceGroupDeploymentWhatIfResult -ResourceGroupName "myRG1" -TemplateParameterFile "./parameters.bicepparam"Este comando obtiene un resultado What-If en el ámbito del grupo de recursos mediante un archivo .bicepparam en el disco. El comando usa el parámetro TemplateParameterFile para especificar un archivo .bicepparam.
Parámetros
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeChangeType
Tipos de cambio de recursos separados por comas que se excluirán de los resultados what-if.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Mode
Modo de implementación.
| Type: | DeploymentMode |
| Accepted values: | Incremental, Complete |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Nombre de la implementación que va a crear. Si no se especifica, el valor predeterminado es el nombre de archivo de plantilla cuando se proporciona un archivo de plantilla; el valor predeterminado es la hora actual en que se proporciona un objeto de plantilla, por ejemplo, "20131223140835".
| Type: | String |
| Aliases: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
Cuando se establece, indica que el cmdlet debe usar versiones de API de versión preliminar al determinar automáticamente qué versión se va a usar.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
El nombre del grupo de recursos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResultFormat
Formato de resultado What-If.
| Type: | WhatIfResultFormat |
| Accepted values: | ResourceIdOnly, FullResourcePayloads |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipTemplateParameterPrompt
Omite el procesamiento de parámetros dinámicos de PowerShell que comprueba si el parámetro de plantilla proporcionado contiene todos los parámetros necesarios usados por la plantilla. Esta comprobación solicitaría al usuario que proporcione un valor para los parámetros que faltan, pero si se proporciona -SkipTemplateParameterPrompt, se omitirá este mensaje y se producirá un error inmediatamente si se encontró que un parámetro no está enlazado en la plantilla. En el caso de los scripts no interactivos, se puede proporcionar -SkipTemplateParameterPrompt para proporcionar un mejor mensaje de error en caso de que no se cumplan todos los parámetros necesarios.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TemplateFile
Ruta de acceso local al archivo de plantilla. Tipo de archivo de plantilla admitido: json y bicep.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateObject
Tabla hash que representa la plantilla.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterFile
Archivo de parámetros que se va a usar para la plantilla.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterObject
Tabla hash que representa los parámetros.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterUri
Uri al archivo de parámetros de plantilla.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateSpecId
Identificador de recurso de templateSpec que se va a implementar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateUri
Uri al archivo de plantilla.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entradas
Salidas
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de