< Back
Remove-AzureRmTrafficManagerProfile
Post
NAME Remove-AzureRmTrafficManagerProfile
SYNOPSIS
Deletes a Traffic Manager profile.
SYNTAX
Remove-AzureRmTrafficManagerProfile [-DefaultProfile <IAzureContextContainer>] [-Force] -Name <String> -ResourceGroupName <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
Remove-AzureRmTrafficManagerProfile [-DefaultProfile <IAzureContextContainer>] [-Force] -TrafficManagerProfile <TrafficManagerProfile> [-Confirm]
[-WhatIf] [<CommonParameters>]
DESCRIPTION
The Remove-AzureRmTrafficManagerProfile cmdlet deletes an Azure Traffic Manager profile. Specify the profile to delete by using the Name and
ResourceGroupName parameters. Alternatively, you can specify a TrafficManagerProfile object using the TrafficManagerProfile parameter, or you can
use the pipeline.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies the name of the Traffic Manager profile that this cmdlet deletes.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of a resource group. This cmdlet deletes a Traffic Manager profile in the group that this parameter specifies.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TrafficManagerProfile <TrafficManagerProfile>
Specifies a TrafficManagerProfile object to delete. To obtain a TrafficManagerProfile object, use the Get-AzureRmTrafficManagerProfile cmdlet.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Azure.Commands.Network.TrafficManagerProfile
This cmdlet accepts a TrafficManagerProfile object.
OUTPUTS
Boolean
This cmdlet returns a value of $True, if it succeeds or, if the deletion fails, a value of $False.
NOTES
Example 1: Delete a profile specified by name
PS C:\\>Remove-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
This command deletes the profile named ContosoProfile in ResourceGroup11. The command prompts you for confirmation.
Example 2: Delete a profile by using the pipeline
PS C:\\>Get-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" | Remove-AzureRmTrafficManagerProfile -Force
This command gets the profile named ContosoProfile in ResourceGroup11. The command then passes that profile to the
Remove-AzureRmTrafficManagerProfile cmdlet by using the pipeline operator. That cmdlet deletes that profile. The command specifies the Force
parameter. Therefore, it does not prompt you for confirmation.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... gerprofile
Disable-AzureRmTrafficManagerProfile
Enable-AzureRmTrafficManagerProfile
Get-AzureRmTrafficManagerProfile
New-AzureRmTrafficManagerProfile
Set-AzureRmTrafficManagerProfile
SYNOPSIS
Deletes a Traffic Manager profile.
SYNTAX
Remove-AzureRmTrafficManagerProfile [-DefaultProfile <IAzureContextContainer>] [-Force] -Name <String> -ResourceGroupName <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
Remove-AzureRmTrafficManagerProfile [-DefaultProfile <IAzureContextContainer>] [-Force] -TrafficManagerProfile <TrafficManagerProfile> [-Confirm]
[-WhatIf] [<CommonParameters>]
DESCRIPTION
The Remove-AzureRmTrafficManagerProfile cmdlet deletes an Azure Traffic Manager profile. Specify the profile to delete by using the Name and
ResourceGroupName parameters. Alternatively, you can specify a TrafficManagerProfile object using the TrafficManagerProfile parameter, or you can
use the pipeline.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies the name of the Traffic Manager profile that this cmdlet deletes.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of a resource group. This cmdlet deletes a Traffic Manager profile in the group that this parameter specifies.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TrafficManagerProfile <TrafficManagerProfile>
Specifies a TrafficManagerProfile object to delete. To obtain a TrafficManagerProfile object, use the Get-AzureRmTrafficManagerProfile cmdlet.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Azure.Commands.Network.TrafficManagerProfile
This cmdlet accepts a TrafficManagerProfile object.
OUTPUTS
Boolean
This cmdlet returns a value of $True, if it succeeds or, if the deletion fails, a value of $False.
NOTES
Example 1: Delete a profile specified by name
PS C:\\>Remove-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
This command deletes the profile named ContosoProfile in ResourceGroup11. The command prompts you for confirmation.
Example 2: Delete a profile by using the pipeline
PS C:\\>Get-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" | Remove-AzureRmTrafficManagerProfile -Force
This command gets the profile named ContosoProfile in ResourceGroup11. The command then passes that profile to the
Remove-AzureRmTrafficManagerProfile cmdlet by using the pipeline operator. That cmdlet deletes that profile. The command specifies the Force
parameter. Therefore, it does not prompt you for confirmation.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... gerprofile
Disable-AzureRmTrafficManagerProfile
Enable-AzureRmTrafficManagerProfile
Get-AzureRmTrafficManagerProfile
New-AzureRmTrafficManagerProfile
Set-AzureRmTrafficManagerProfile