Partilhar via


Set-AzWebApp

Modifica um Aplicativo Web do Azure.

Sintaxe

S1

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>]
    [-ResourceGroupName] <String>
    [-Name] <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>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

S2

Set-AzWebApp
    [[-Use32BitWorkerProcess] <Boolean>]
    [[-AutoSwapSlotName] <String>]
    [-WebApp] <PSSite>
    [-NumberOfWorkers <Int32>]
    [-AsJob]
    [-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"

Este comando altera o plano appservice associado ao Aplicativo Web ContosoWebApp associado ao grupo de recursos Default-Web-WestUS. Use o link para saber mais sobre como alterar o plano do appservice 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

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

Exemplo 3

Modifica um Aplicativo Web do Azure. (autogenerated)

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 Web App 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 Web App

$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

Certifique-se de que o aplicativo Web seja carregado o tempo todo, em vez de descarregado depois de ficar ocioso.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AppServicePlan

Nome do Plano do Serviço de Aplicativo

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AppSettings

Configurações do aplicativo HashTable. As Definições da Aplicação existentes serão substituídas, removendo quaisquer definições que não sejam fornecidas.

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:9
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AssignIdentity

Habilitar/desabilitar MSI em um aplicativo web azure existente ou functionapp

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AutoSwapSlotName

Nome do slot de destino para troca automática

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:15
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AzureStoragePath

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

Propriedades dos parâmetros

Tipo:

WebAppAzureStoragePath[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ConnectionStrings

Cadeias de conexão HashTable

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:10
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ContainerImageName

Nome da imagem do contêiner

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ContainerRegistryPassword

Senha do Registro de Contêiner Privado

Propriedades dos parâmetros

Tipo:SecureString
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ContainerRegistryUrl

URL do Servidor de Registro de Contêiner Privado

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ContainerRegistryUser

Nome de usuário do Private Container Registry

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultDocuments

Matriz de cadeia de caracteres de documentos padrão

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DetailedErrorLoggingEnabled

Registro detalhado de erros habilitado Boolean

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:8
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnableContainerContinuousDeployment

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FtpsState

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:AllAllowed, Disabled, FtpsOnly
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HandlerMappings

IList de mapeamentos de manipulador

Propriedades dos parâmetros

Tipo:

IList<T>[Microsoft.Azure.Management.WebSites.Models.HandlerMapping]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:11
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HostNames

Matriz de cadeia de caracteres WebApp HostNames

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HttpLoggingEnabled

Booleano HttpLoggingEnabled

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HttpsOnly

Ativar/desativar o redirecionamento de todo o tráfego para HTTPS em um aplicativo web ou functionapp azure existente

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ManagedPipelineMode

Nome do Modo de Pipeline Gerenciado

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Classic, Integrated
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:12
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MinTlsVersion

A versão mínima do TLS necessária para solicitações SSL. Valores permitidos [1,0 | 1,1 | 1,2].

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:1.0, 1.1, 1.2
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Nome do WebApp

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-NetFrameworkVersion

Versão do Net Framework

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NumberOfWorkers

Número de trabalhadores a atribuir

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PhpVersion

Versão Php

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RequestTracingEnabled

Rastreamento de solicitações habilitado

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

Nome do Grupo de Recursos

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Use32BitWorkerProcess

Usar booleano de processo de trabalho de 32 bits

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:14
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WebApp

Objeto WebApp

Propriedades dos parâmetros

Tipo:PSSite
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S2
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WebSocketsEnabled

Booleano WebSocketsEnabled

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

S1
Position:13
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Int32

String

PSSite

Saídas

PSSite

Notas

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 pelo nome do Default-Web-WestUS grupo de recursos do webapp e ContosoWebApp pelo nome do webapp.