Dela via


Remove-AzureSubscription

Tar bort en Azure-prenumeration från Windows PowerShell.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

Syntax

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

Description

Cmdleten Remove-AzureSubscription tar bort en Azure-prenumeration från din prenumerationsdatafil så att Windows PowerShell inte kan hitta den. Den här cmdleten tar inte bort prenumerationen från Microsoft Azure eller ändrar den faktiska prenumerationen på något sätt.

Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen. Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .

Exempel

Exempel 1: Ta bort en prenumeration

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"):

Det här kommandot tar bort prenumerationen "Test" från standardprenumerationsdatafilen.

Exempel 2: Ta bort från en alternativ prenumerationsdatafil

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

Det här kommandot tar bort testprenumerationen från datafilen MySubscriptions.xml-prenumeration. Kommandot använder parametern Force för att ignorera bekräftelseprompten.

Exempel 3: Ta bort en prenumeration i ett skript

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

Det här kommandot använder kommandot Remove-AzureSubscription i en If-instruktion . Den använder parametern PassThru, som returnerar ett booleskt värde, för att avgöra om skriptblocket i If-instruktionen körs.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Force

Undertrycker bekräftelseprompten.

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

-PassThru

Returnerar $True om kommandot lyckas och $False om det misslyckas. Som standard returnerar den här cmdleten inga utdata.

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

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

None

Du kan skicka indata till den här cmdleten efter egenskapsnamn, men inte efter värde.

Utdata

None or System.Boolean

Om du använder parametern PassThru returnerar den här cmdleten ett booleskt värde. Annars returneras inga utdata.