Compartilhar via

New-AzureDeployment

  • Referência
Módulo:
Azure

Cria uma implantação de um serviço.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell 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. 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) .

Sintaxe

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. Esse 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.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DoNotStart

Especifica que esse cmdlet não inicia a implantação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExtensionConfiguration

Especifica uma matriz de objetos de configuração de extensão.

Tipo:ExtensionConfigurationInput[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome de implantação. Se você não especificar um nome, esse cmdlet usará um GUID.

Tipo:String
Aliases:DeploymentName
Cargo:5
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Package

Especifica o caminho ou o URI de um arquivo .cspkg no armazenamento dentro da mesma assinatura ou projeto.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServiceName

Especifica o nome do serviço do Azure para a implantação.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Slot

Especifica o ambiente em que esse cmdlet cria a implantação. Os valores válidos são: Preparo e Produção. O valor padrão é Produção.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False