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 Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

Syntax

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 gegevensbestand MySubscriptions.xml-abonnement 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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Onderdrukt de bevestigingsprompt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionName

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.