New-AzureDeployment
Cria uma implantação a partir de um serviço.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
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. As novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido) .
Syntax
New-AzureDeployment
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Label] <String>]
[[-Name] <String>]
[-DoNotStart]
[-TreatWarningsAsError]
[-ExtensionConfiguration <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet New-AzureDeployment cria uma implantação do Azure a partir de um serviço que compreende funções Web e funções de trabalho. Esse cmdlet cria uma implantação com base em um arquivo de pacote (.cspkg) e um arquivo de configuração de serviço (.cscfg). Especifique um nome exclusivo no ambiente de implantação.
Use o cmdlet New-AzureVM para criar uma implantação com base em máquinas virtuais do Azure.
Exemplos
Exemplo 1: Criar uma implantação
PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Label "ContosoDeployment"
Esse comando cria uma implantação de produção com base em um pacote chamado ContosoPackage.cspkg e uma configuração chamada ContosoConfiguration.cscfg. O comando especifica um rótulo para a implantação. Ele não especifica um nome. Este cmdlet cria um GUID como o nome.
Exemplo 2: Criar uma implantação com base em uma configuração de extensão
PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"
Esse comando cria uma implantação de produção com base em um pacote e configuração. O comando especifica uma configuração de extensão chamada ContosoExtensionConfig.cscfg. Esse cmdlet cria GUIDs como o nome e o rótulo.
Parâmetros
-Configuration
Especifica o caminho completo de um arquivo de configuração de serviço.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DoNotStart
Especifica que esse cmdlet não inicia a implantação.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionConfiguration
Especifica uma matriz de objetos de configuração de extensão.
Type: | ExtensionConfigurationInput[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informações.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Especifica uma variável de informação.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Especifica um nome de rótulo para a implantação. Se você não especificar um rótulo, esse cmdlet usará um GUID.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica um nome de implantação. Se você não especificar um nome, esse cmdlet usará um GUID.
Type: | String |
Aliases: | DeploymentName |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
Especifica o caminho ou o URI de um arquivo .cspkg no armazenamento na mesma assinatura ou projeto.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceName
Especifica o nome do serviço do Azure para a implantação.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Especifica o ambiente onde esse cmdlet cria a implantação. Os valores válidos são: Preparação e Produção. O valor padrão é Production.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TreatWarningsAsError
Especifica que as mensagens de aviso são erros. Se você especificar esse parâmetro, uma mensagem de aviso fará com que a implantação falhe.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |