Switch-AzWebAppSlot
Swap two slots within a Web App
Note
This is the previous version of our documentation. Please consult the most recent version for up-to-date information.
Syntax
Switch-AzWebAppSlot
[-SourceSlotName] <String>
[[-DestinationSlotName] <String>]
[[-SwapWithPreviewAction] <SwapWithPreviewAction>]
[[-PreserveVnet] <Boolean>]
[-ResourceGroupName] <String>
[-Name] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Switch-AzWebAppSlot
[-SourceSlotName] <String>
[[-DestinationSlotName] <String>]
[[-SwapWithPreviewAction] <SwapWithPreviewAction>]
[[-PreserveVnet] <Boolean>]
[-WebApp] <PSSite>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Switch-AzWebAppSlot cmdlet switches two slots associated with an Azure Web App.
Examples
Example 1
Switch-AzWebAppSlot -SourceSlotName "sourceslot" -DestinationSlotName "destinationslot" -ResourceGroupName "Default-Web-WestUS" -Name "ContosoWebApp"
This command will switch slot "sourceslot" with slot "destinationslot" on the Web App ContosoWebApp in the resource group Default-Web-WestUS.
Note
Use "production" as the slot name when the either the source or destination slot is intended to be the production slot.
Parameters
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The credentials, account, tenant, and subscription used for communication with azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Destination Slot Name
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
WebApp Name
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Preserve Vnet Boolean
| Type: | Nullable<T>[Boolean] |
| Position: | 3 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Resource Group Name
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Source Slot Name
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Swap With Preview Action
| Type: | Nullable<T>[SwapWithPreviewAction] |
| Accepted values: | ApplySlotConfig, CompleteSlotSwap, ResetSlotSwap |
| Position: | 2 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
WebApp Object
| Type: | PSSite |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |