Compartilhar via


Set-AzWebApp

Modifica um aplicativo Web do Azure.

Sintaxe

Set-AzWebApp
   [[-AppServicePlan] <String>]
   [[-DefaultDocuments] <String[]>]
   [[-NetFrameworkVersion] <String>]
   [[-PhpVersion] <String>]
   [[-RequestTracingEnabled] <Boolean>]
   [[-HttpLoggingEnabled] <Boolean>]
   [[-DetailedErrorLoggingEnabled] <Boolean>]
   [[-AppSettings] <Hashtable>]
   [[-ConnectionStrings] <Hashtable>]
   [[-HandlerMappings] <System.Collections.Generic.IList`1[Microsoft.Azure.Management.WebSites.Models.HandlerMapping]>]
   [[-ManagedPipelineMode] <String>]
   [[-WebSocketsEnabled] <Boolean>]
   [[-Use32BitWorkerProcess] <Boolean>]
   [[-AutoSwapSlotName] <String>]
   [-ContainerImageName <String>]
   [-ContainerRegistryUrl <String>]
   [-ContainerRegistryUser <String>]
   [-ContainerRegistryPassword <SecureString>]
   [-EnableContainerContinuousDeployment <Boolean>]
   [-HostNames <String[]>]
   [-NumberOfWorkers <Int32>]
   [-AsJob]
   [-AssignIdentity <Boolean>]
   [-HttpsOnly <Boolean>]
   [-AzureStoragePath <WebAppAzureStoragePath[]>]
   [-AlwaysOn <Boolean>]
   [-MinTlsVersion <String>]
   [-FtpsState <String>]
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzWebApp
   [[-Use32BitWorkerProcess] <Boolean>]
   [[-AutoSwapSlotName] <String>]
   [-NumberOfWorkers <Int32>]
   [-AsJob]
   [-WebApp] <PSSite>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzWebApp define um Aplicativo Web do Azure.

Exemplos

Exemplo 1

Set-AzWebApp -ResourceGroupName "Default-Web-WestUS" -Name "ContosoWebApp" -AppServicePlan "ContosoPlan"

Esse comando altera o plano de serviço de aplicativo associado ao Aplicativo Web ContosoWebApp associado ao grupo de recursos Default-Web-WestUS. Use o link para saber mais sobre como alterar o plano de serviço de aplicativo e as restrições associadas a ele. https://learn.microsoft.com/azure/app-service/app-service-plan-manage#move-an-app-to-another-app-service-plan

Exemplo 2

Set-AzWebApp -ResourceGroupName "Default-Web-WestUS" -Name "ContosoWebApp" -HttpLoggingEnabled $true

Esse comando define HttpLoggingEnabled como true para o Aplicativo Web ContosoWebApp associado ao grupo de recursos Default-Web-WestUS

Exemplo 3

Modifica um aplicativo Web do Azure. (gerado automaticamente)

Set-AzWebApp -AppSettings <Hashtable> -Name 'ContosoWebApp' -ResourceGroupName 'Default-Web-WestUS'

Exemplo 4

O exemplo a seguir cria uma cadeia de conexão chamada myConnectionString para Aplicativo Web ContosoWebApp. Isso substitui todas as cadeias de conexão existentes para o Aplicativo Web ContosoWebApp.

$hashtable =  @{myConnectionString = @{Type='MySql';Value='MySql Connection string'}}
Set-AzWebApp -Name 'ContosoWebApp' -ResourceGroupName 'Default-Web-WestUS' -ConnectionStrings $hashtable

Exemplo 5

Habilitar insights de aplicativos para o Aplicativo Web

$key=(Get-AzApplicationInsights -ResourceId $ai).InstrumentationKey
$setting=@{"ApplicationInsightsAgent_EXTENSION_VERSION"="~3"; "APPINSIGHTS_INSTRUMENTATIONKEY"=$key}
Set-AzWebApp -AppSettings $setting -Name 'ContosoWebApp' -ResourceGroupName 'Default-Web-WestUS'

Parâmetros

-AlwaysOn

Verifique se o aplicativo Web é carregado o tempo todo, em vez de descarregado após ficar ocioso.

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

-AppServicePlan

Nome do Plano do Serviço de Aplicativo

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

-AppSettings

HashTable de Configurações do Aplicativo. As Configurações de Aplicativo Existentes serão substituídas, removendo as configurações que não forem fornecidas.

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

-AsJob

Executar cmdlet em segundo plano

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

-AssignIdentity

Habilitar/desabilitar a MSI em um aplicativo Web ou functionapp do azure existente

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

-AutoSwapSlotName

Nome do slot de destino para troca automática

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

-AzureStoragePath

Armazenamento do Azure para montar dentro de um Aplicativo Web para Contêiner. Usar New-AzWebAppAzureStoragePath para criá-lo

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

-ConnectionStrings

HashTable cadeias de conexão

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

-ContainerImageName

Nome da imagem do contêiner

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

-ContainerRegistryPassword

Senha do Registro de Contêiner Privado

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

-ContainerRegistryUrl

URL do Servidor do Registro de Contêiner Privado

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

-ContainerRegistryUser

Nome de usuário do Registro de Contêiner Privado

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

-DefaultDocuments

Matriz de cadeia de caracteres de documentos padrão

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DetailedErrorLoggingEnabled

Erro detalhado do booliano habilitado para registro em log

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

-EnableContainerContinuousDeployment

Habilita/desabilita o webhook de implantação contínua do contêiner

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

-FtpsState

Defina o valor do estado ftps para um aplicativo. Valores permitidos [AllAllowed | Desabilitado | FtpsOnly].

Tipo:String
Valores aceitos:AllAllowed, Disabled, FtpsOnly
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HandlerMappings

IList de mapeamentos de manipulador

Tipo:IList<T>[HandlerMapping]
Cargo:11
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HostNames

Matriz de cadeias de caracteres HostNames do WebApp

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

-HttpLoggingEnabled

HttpLoggingEnabled Boolean

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

-HttpsOnly

Habilitar/desabilitar o redirecionamento de todo o tráfego para HTTPS em um aplicativo Web ou functionapp do azure existente

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

-ManagedPipelineMode

Nome do modo de pipeline gerenciado

Tipo:String
Valores aceitos:Classic, Integrated
Cargo:12
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MinTlsVersion

A versão mínima do TLS necessária para solicitações SSL. Valores permitidos [1.0 | 1.1 | 1.2].

Tipo:String
Valores aceitos:1.0, 1.1, 1.2
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Nome do WebApp

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

-NetFrameworkVersion

Versão do Net Framework

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

-NumberOfWorkers

O número de trabalhadores a serem alocados

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

-PhpVersion

Versão do Php

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

-RequestTracingEnabled

Rastreamento de solicitação habilitado

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

-ResourceGroupName

Nome do Grupo de Recursos

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

-Use32BitWorkerProcess

Usar o processo de trabalho booliano de 32 bits

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

-WebApp

Objeto WebApp

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

-WebSocketsEnabled

WebSocketsEnabled Boolean

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

Entradas

Int32

String

PSSite

Saídas

PSSite

Observações

O cmdlet fornecido abaixo ajudará você a atualizar o Aplicativo Web do Azure para DOTNETCORE $PropertiesObject = @{ "CURRENT_STACK" = "dotnetcore" } New-AzResource -PropertyObject $PropertiesObject -ResourceGroupName "Default-Web-WestUS" -ResourceType Microsoft.Web/sites/config -ResourceName "ContosoWebApp/metadata" -ApiVersion 2018-02-01 -Force Substitua os valores de Default-Web-WestUS pelo nome do grupo de recursos do aplicativo Web e ContosoWebApp pelo nome do aplicativo Web.