Remove-​Azure​Rm​Resource

Removes a resource.

Syntax

Remove-AzureRmResource
      [-ApiVersion <String>]
      [-Force]
      [-ResourceGroupName <String>]
      -ResourceType <String>
      [-WhatIf]
      [-Confirm]
      [-ExtensionResourceName <String>]
      [-ExtensionResourceType <String>]
      [-ODataQuery <String>]
      [-Pre]
      -ResourceName <String>
      [<CommonParameters>]
Remove-AzureRmResource
      [-ApiVersion <String>]
      [-Force]
      -ResourceType <String>
      [-WhatIf]
      [-Confirm]
      [-ExtensionResourceName <String>]
      [-ExtensionResourceType <String>]
      [-ODataQuery <String>]
      [-Pre]
      -ResourceName <String>
      [-TenantLevel]
      [<CommonParameters>]
Remove-AzureRmResource
      [-ApiVersion <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-ODataQuery <String>]
      [-Pre]
      -ResourceId <String>
      [<CommonParameters>]

Description

The Remove-AzureRmResource cmdlet removes an Azure resource.

Examples

Example 1: Remove a website resource

PS C:\>Remove-AzureRmResource -ResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup11/providers/Microsoft.Web/sites/ContosoSite" -Force

This command removes the website resource named ContosoSite. The example uses a placeholder value for the subscription ID. The command specifies the Force parameter. Therefore, it does not prompt you for confirmation.

Required Parameters

-ResourceId

Specifies the fully qualified resource ID of the resource that this cmdlet removes. The ID includes the subscription, as in the following example: /subscriptions/subscription ID/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Type:String
Aliases:Id
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ResourceName

Specifies the name of the resource that this cmdlet removes. For instance, to specify a database, use the following format: ContosoServer/ContosoDatabase

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ResourceType

Specifies the type of the resource that this cmdlet removes. For instance, for a database, the resource type is as follows: Microsoft.Sql/Servers/Databases

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-TenantLevel

Indicates that this cmdlet operates at the tenant level.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-ApiVersion

Specifies the version of the resource provider API to use. If you do not specify a version, this cmdlet uses the latest available version.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-ExtensionResourceName

Specifies the name of an extension resource of the resource that this cmdlet removes. For instance, to specify a database, use the following format: server name/database name

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ExtensionResourceType

Specifies the resource type for an extension resource. Specifies the extension resource type for the resource. For instance: Microsoft.Sql/Servers/Databases

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ODataQuery

Specifies an Open Data Protocol (OData) style filter. This cmdlet appends this value to the request in addition to any other filters.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Pre

Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Specifies the name of the resource group from which this cmdlet removes a resource.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False