Remove-AzResource
Syntax
ByResourceId (Standard)
Remove-AzResource
-ResourceId <String>
[-AsJob]
[-ODataQuery <String>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
BySubscriptionLevel
Remove-AzResource
-ResourceName <String>
-ResourceType <String>
[-AsJob]
[-ExtensionResourceName <String>]
[-ExtensionResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByTenantLevel
Remove-AzResource
-ResourceName <String>
-ResourceType <String>
[-AsJob]
[-ExtensionResourceName <String>]
[-ExtensionResourceType <String>]
[-ODataQuery <String>]
[-TenantLevel]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Remove-AzResource entfernt eine Azure-Ressource .
Beispiele
Beispiel 1: Entfernen einer Websiteressource
Remove-AzResource -ResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup11/providers/Microsoft.Web/sites/ContosoSite" -Force
Mit diesem Befehl wird die Websiteressource "ContosoSite" entfernt.
Im Beispiel wird ein Platzhalterwert für die Abonnement-ID verwendet.
Der Befehl gibt den Force-Parameter an.
Daher werden Sie nicht zur Bestätigung aufgefordert.
Parameter
-ApiVersion
Gibt die version der zu verwendenden Ressourcenanbieter-API an.
Wenn Sie keine Version angeben, verwendet dieses Cmdlet die neueste verfügbare Version.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-AsJob
Cmdlet im Hintergrund ausführen
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: vgl
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-ExtensionResourceName
Gibt den Namen einer Erweiterungsressource der Ressource an, die dieses Cmdlet entfernt.
Verwenden Sie z. B. zum Angeben einer Datenbank das folgende Format: Servername-Datenbankname/
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
BySubscriptionLevel
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
ByTenantLevel
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ExtensionResourceType
Gibt den Ressourcentyp für eine Erweiterungsressource an.
Gibt den Erweiterungsressourcentyp für die Ressource an.
Beispiel: Microsoft.Sql/Servers/Databases
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
BySubscriptionLevel
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
ByTenantLevel
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Force
Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-ODataQuery
Gibt einen OData-Formatvorlagenfilter (Open Data Protocol) an.
Dieses Cmdlet fügt diesen Wert zusätzlich zu anderen Filtern an die Anforderung an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Pre
Gibt an, dass dieses Cmdlet vorab veröffentlichte API-Versionen berücksichtigt, wenn es automatisch bestimmt, welche Version verwendet werden soll.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Gibt den Namen der Ressourcengruppe an, aus der dieses Cmdlet eine Ressource entfernt.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
BySubscriptionLevel
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ResourceId
Gibt die vollqualifizierte Ressourcen-ID der Ressource an, die dieses Cmdlet entfernt.
Die ID enthält das Abonnement, wie im folgenden Beispiel: /subscriptions/Abonnement-ID/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Id
Parametersätze
ByResourceId
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ResourceName
Gibt den Namen der Ressource an, die dieses Cmdlet entfernt.
Verwenden Sie z. B. zum Angeben einer Datenbank das folgende Format: ContosoServer/ContosoDatabase
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Name
Parametersätze
BySubscriptionLevel
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
ByTenantLevel
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ResourceType
Gibt den Typ der Ressource an, die dieses Cmdlet entfernt.
Für eine Datenbank lautet der Ressourcentyp z. B. wie folgt: Microsoft.Sql/Servers/Databases
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
BySubscriptionLevel
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
ByTenantLevel
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-TenantLevel
Gibt an, dass dieses Cmdlet auf Mandantenebene ausgeführt wird.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
ByTenantLevel
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird.
Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Wi
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben