Delen via

Remove-AzureSubscription

  • Referentie
Module:
Azure

Hiermee verwijdert u een Azure-abonnement uit Windows PowerShell.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

Remove-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met de cmdlet Remove-AzureSubscription wordt een Azure-abonnement verwijderd uit uw abonnementsgegevensbestand, zodat Windows PowerShell het niet kan vinden. Met deze cmdlet wordt het abonnement niet uit Microsoft Azure verwijderd of wordt het daadwerkelijke abonnement op geen enkele manier gewijzigd.

In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven. Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

Voorbeelden

Voorbeeld 1: Een abonnement verwijderen

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Met deze opdracht wordt het abonnement Testen verwijderd uit het standaardgegevensbestand van het abonnement.

Voorbeeld 2: Verwijderen uit een alternatief abonnementsgegevensbestand

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

Met deze opdracht wordt het testabonnement uit het MySubscriptions.xml-abonnementsgegevensbestand verwijderd. De opdracht gebruikt de parameter Force om de bevestigingsprompt te onderdrukken.

Voorbeeld 3: Een abonnement in een script verwijderen

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

Deze opdracht maakt gebruik van de opdracht Remove-AzureSubscription in een If-instructie . Hierbij wordt de Parameter PassThru gebruikt, die een Booleaanse waarde retourneert, om te bepalen of het scriptblok in de If-instructie wordt uitgevoerd.

Parameters

-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

-Force

Onderdrukt de bevestigingsprompt.

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

-PassThru

Retourneert $True als de opdracht slaagt en $False als deze mislukt. Deze cmdlet retourneert standaard geen uitvoer.

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

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

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

-SubscriptionId

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

-SubscriptionName

Type:String
Aliassen:Name
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
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

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

None or System.Boolean

Als u de parameter PassThru gebruikt, retourneert deze cmdlet een Booleaanse waarde. Anders retourneert deze geen uitvoer.