Delen via

Remove-AzResource

  • Referentie
Module:
Az.Resources

Hiermee verwijdert u een resource.

Syntaxis

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

Description

Met de cmdlet Remove-AzResource wordt een Azure-resource verwijderd.

Voorbeelden

Voorbeeld 1: Een websiteresource verwijderen

Remove-AzResource -ResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup11/providers/Microsoft.Web/sites/ContosoSite" -Force

Met deze opdracht wordt de websiteresource met de naam ContosoSite verwijderd. In het voorbeeld wordt een tijdelijke aanduidingswaarde gebruikt voor de abonnements-id. Met de opdracht geeft u de parameter Force op. Daarom wordt u niet om bevestiging gevraagd.

Parameters

-ApiVersion

Hiermee geeft u de versie van de resourceprovider-API die moet worden gebruikt. Als u geen versie opgeeft, gebruikt deze cmdlet de meest recente beschikbare versie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExtensionResourceName

Hiermee geeft u de naam op van een extensieresource van de resource die door deze cmdlet wordt verwijderd. Als u bijvoorbeeld een database wilt opgeven, gebruikt u de volgende indeling: servernaamdatabasenaam/

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExtensionResourceType

Hiermee geeft u het resourcetype voor een extensieresource op. Hiermee geeft u het extensieresourcetype voor de resource op. Bijvoorbeeld: Microsoft.Sql/Servers/Databases

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ODataQuery

Hiermee geeft u een OData-stijlfilter (Open Data Protocol) op. Deze cmdlet voegt deze waarde toe aan de aanvraag naast andere filters.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waaruit deze cmdlet een resource verwijdert.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

Hiermee geeft u de volledig gekwalificeerde resource-id op van de resource die door deze cmdlet wordt verwijderd. De id bevat het abonnement, zoals in het volgende voorbeeld: /subscriptions/abonnements-id/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Type:String
Aliassen:Id
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceName

Hiermee geeft u de naam op van de resource die door deze cmdlet wordt verwijderd. Als u bijvoorbeeld een database wilt opgeven, gebruikt u de volgende indeling: ContosoServer/ContosoDatabase

Type:String
Aliassen:Name
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceType

Hiermee geeft u het type van de resource die door deze cmdlet wordt verwijderd. Voor een database is het resourcetype bijvoorbeeld als volgt: Microsoft.Sql/Servers/Databases

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TenantLevel

Geeft aan dat deze cmdlet werkt op tenantniveau.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

Boolean