Sdílet prostřednictvím

Remove-AzureSubscription

  • Reference
Modul:
Azure

Odstraní předplatné Azure z Prostředí Windows PowerShell.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Description

Rutina Remove-AzureSubscription odstraní předplatné Azure z datového souboru předplatného, aby ho Windows PowerShell nemohl najít. Tato rutina neodstraní předplatné z Microsoft Azure ani nijak nezmění skutečné předplatné.

Toto téma popisuje rutinu ve verzi 0.8.10 modulu Microsoft Azure PowerShell. Pokud chcete získat verzi modulu, který používáte, zadejte (Get-Module -Name Azure).Versionv konzole Azure PowerShellu .

Příklady

Příklad 1: Odstranění předplatného

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

Tento příkaz odstraní odběr Test z výchozího datového souboru předplatného.

Příklad 2: Odstranění z alternativního datového souboru předplatného

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

Tento příkaz odstraní testovací předplatné z datového souboru MySubscriptions.xml předplatného. Příkaz používá parametr Force k potlačení potvrzovací výzvy.

Příklad 3: Odstranění předplatného ve skriptu

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

Tento příkaz používá příkaz Remove-AzureSubscription v příkazu If . Používá parametr PassThru , který vrací logickou hodnotu, k určení, zda je blok skriptu v příkazu If proveden.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Potlačí výzvu k potvrzení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí $True, pokud příkaz proběhne úspěšně a $False, pokud selže. Ve výchozím nastavení tato rutina nevrací žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubscriptionId

Typ:String
Aliasy:Id
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SubscriptionName

Typ:String
Aliasy:Name
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny můžete řadit podle názvu vlastnosti, ale ne podle hodnoty.

Výstupy

None or System.Boolean

Pokud použijete parametr PassThru , vrátí tato rutina logickou hodnotu. Jinak nevrací žádný výstup.