Dela via

Remove-AzureSubscription

  • Referens
Modul:
Azure

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

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

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 MySubscriptions.xml-prenumerationsdatafilen. 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.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Undertrycker bekräftelseprompten.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubscriptionId

Typ:String
Alias:Id
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SubscriptionName

Typ:String
Alias:Name
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.