Set-AzureDeployment
Modifica o status, as definições de configuração ou o modo de atualização de uma implantação.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Importante
Os Serviços de Nuvem (clássicos) agora foram preteridos para novos clientes e serão desativados em 31 de agosto de 2024 para todos os clientes. Novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido).
Sintaxe
Set-AzureDeployment
[-Upgrade]
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Mode] <String>]
[[-Label] <String>]
[[-RoleName] <String>]
[-Force]
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Config]
[-ServiceName] <String>
[-Configuration] <String>
[-Slot] <String>
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Status]
[-ServiceName] <String>
[-Slot] <String>
[-NewStatus] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
O cmdlet Set-AzureDeployment modifica o status, as definições de configuração ou o modo de atualização de uma implantação do Azure. Você pode alterar o status da implantação para Em execução ou Suspensa. Você pode alterar o arquivo .cscfg para a implantação. Você pode definir o modo de atualização e atualizar os arquivos de configuração. Use o cmdlet Set-AzureWalkUpgradeDomain para iniciar uma atualização.
Exemplos
Exemplo 1: Alterar o status de uma implantação
PS C:\> Set-AzureDeployment -Status -ServiceName "ContosoService" -Slot "Production" -NewStatus "Running"Este comando define o status da implantação do serviço chamado ContosoService no ambiente de produção como Em execução.
Exemplo 2: Atribuir um arquivo de configuração diferente a uma implantação
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Slot "Staging" -Configuration "C:\Temp\MyServiceConfig.Cloud.csfg"Este comando atribui um arquivo de configuração diferente para a implantação do serviço chamado ContosoService no ambiente de preparação.
Exemplo 3: Definir o modo de atualização como Automático
PS C:\> Set-AzureDeployment -Upgrade -ServiceName "ContosoService" -Mode Auto -Package "C:\packages\ContosoApp.cspkg" -Configuration "C:\Config\ContosoServiceConfig.Cloud.csfg"Este comando define o modo de atualização como Automático e especifica um pacote de atualização e um novo arquivo de configuração.
Exemplo 4: Instalar a configuração de extensão em um serviço
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Mode "Automatic" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Slot "Production" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"Este comando instala a configuração da extensão no Serviço de Nuvem especificado e aplica-a às funções.
Parâmetros
-Config
Especifica que esse cmdlet modifica a configuração da implantação.
| Tipo: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Configuration
Especifica o caminho completo de um arquivo de configuração .cscfg. Você pode especificar um arquivo de configuração para uma atualização ou alteração de configuração.
| Tipo: | String |
| Position: | 3 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ExtensionConfiguration
Especifica uma matriz de objetos de configuração de extensão.
| Tipo: | ExtensionConfigurationInput[] |
| Position: | 9 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Force
Indica que o cmdlet executa uma atualização forçada.
| Tipo: | SwitchParameter |
| Position: | 8 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
| Tipo: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-InformationVariable
Especifica uma variável de informação.
| Tipo: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Label
Especifica um rótulo para a implantação atualizada.
| Tipo: | String |
| Position: | 6 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Mode
Especifica o modo de atualização. Os valores válidos são:
- Automático
- Manual
- Simultâneo
| Tipo: | String |
| Position: | 5 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-NewStatus
Especifica o status de destino para a implantação. Os valores válidos são: Em execução e Suspenso.
| Tipo: | String |
| Position: | 3 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Package
Especifica o caminho completo de um arquivo de pacote de atualização.
| Tipo: | String |
| Position: | 2 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
| Tipo: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RoleName
Especifica o nome da função a ser atualizada.
| Tipo: | String |
| Position: | 7 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ServiceName
Especifica o nome do serviço do Azure da implantação.
| Tipo: | String |
| Position: | 1 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Slot
Especifica o ambiente da implantação a ser modificado. Os valores válidos são: Produção e Preparação.
| Tipo: | String |
| Position: | 4 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Status
Especifica que esse cmdlet altera o status da implantação.
| Tipo: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Upgrade
Especifica que esse cmdlet atualiza a implantação.
| Tipo: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |