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