Set-AzWebApp

Module:

Az.Websites Module

Modifie une application web Azure.

Syntaxe

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

L’applet de commande Set-AzWebApp définit une application web Azure.

Exemples

Exemple 1

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

Cette commande modifie le plan appservice associé à l’application Web ContosoWebApp associée au groupe de ressources Default-Web-WestUS. Utilisez le lien pour en savoir plus sur la modification du plan appservice et des contraintes associées. https://learn.microsoft.com/azure/app-service/app-service-plan-manage#move-an-app-to-another-app-service-plan

Exemple 2

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

Cette commande définit HttpLoggingEnabled sur true pour l’application web ContosoWebApp associée au groupe de ressources Par défaut -Web-WestUS

Exemple 3

Modifie une application web Azure. (autogenerated)

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

Exemple 4

L’exemple suivant crée une chaîne de connexion nommée myConnectionString pour Web App ContosoWebApp. Cela remplace toutes les chaînes de connexion existantes pour Web App ContosoWebApp.

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

Exemple 5

Activer Application Insights pour 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'

Paramètres

-AlwaysOn

Vérifiez que l’application web est chargée tout le temps, plutôt déchargée après avoir été inactive.

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AppServicePlan

Nom du plan App Service

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	2
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AppSettings

HashTable des paramètres de l’application. Les paramètres d’application existants seront remplacés, supprimant les paramètres qui ne sont pas fournis.

Propriétés du paramètre

Type:	Hashtable
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	9
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AssignIdentity

Activer/désactiver MSI sur une application web azure ou une application de fonction azure existante

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AutoSwapSlotName

Nom de l’emplacement de destination pour l’échange automatique

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	15
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AzureStoragePath

Stockage Azure à monter à l’intérieur d’une application web pour conteneur. Utiliser New-AzWebAppAzureStoragePath pour le créer

Propriétés du paramètre

Type:	WebAppAzureStoragePath[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConnectionStrings

Chaînes de connexion HashTable

Propriétés du paramètre

Type:	Hashtable
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	10
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContainerImageName

Nom de l’image conteneur

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContainerRegistryPassword

Mot de passe du registre de conteneurs privé

Propriétés du paramètre

Type:	SecureString
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContainerRegistryUrl

URL du serveur de registre de conteneurs privé

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContainerRegistryUser

Nom d’utilisateur du registre de conteneurs privé

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultDocuments

Tableau de chaînes de documents par défaut

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	3
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DetailedErrorLoggingEnabled

Journalisation des erreurs détaillée activée booléenne

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	8
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-EnableContainerContinuousDeployment

Active/désactive le webhook de déploiement continu du conteneur

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FtpsState

Définissez la valeur d’état Ftps pour une application. Valeurs autorisées [AllAllowed | Désactivé | FtpsOnly].

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	AllAllowed, Disabled, FtpsOnly
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-HandlerMappings

Mappages de gestionnaires IList

Propriétés du paramètre

Type:	IList<T>[Microsoft.Azure.Management.WebSites.Models.HandlerMapping]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	11
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-HostNames

WebApp HostNames String Array

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-HttpLoggingEnabled

HttpLoggingEnabled Boolean

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	7
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-HttpsOnly

Activer/désactiver la redirection de tout le trafic vers HTTPS sur une application web Azure existante ou functionapp

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ManagedPipelineMode

Nom du mode pipeline managé

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Classic, Integrated
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	12
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MinTlsVersion

Version minimale de TLS requise pour les requêtes SSL. Valeurs autorisées [1.0 | 1.1 | 1.2].

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	1.0, 1.1, 1.2
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Nom de l’application web

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-NetFrameworkVersion

Version du cadre Net

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	4
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NumberOfWorkers

Nombre de travailleurs à allouer

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PhpVersion

Php Version

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	5
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RequestTracingEnabled

Suivi des demandes activé

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	6
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceGroupName

Nom du groupe de ressources

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Use32BitWorkerProcess

Utiliser le processus Worker 32 bits booléen

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	14
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WebApp

WebApp, objet

Propriétés du paramètre

Type:	PSSite
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S2

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WebSocketsEnabled

WebSocketsEnabled Boolean

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

S1

Position:	13
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Int32

String

PSSite

Sorties

PSSite

Notes

L’applet de commande ci-dessous vous aidera à mettre à jour Azure Web App vers 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 Remplacer les valeurs par le nom de votre groupe de Default-Web-WestUS ressources de l’application web et ContosoWebApp par le nom de l’application web.

Liens associés

• Get-AzWebApp
• New-AzWebApp
• Remove-AzWebApp
• Restart-AzWebApp
• Start-AzWebApp
• Stop-AzWebApp
• New-AzResource