Udostępnij za pośrednictwem


Remove-AzureEnvironment

Usuwa środowisko platformy Azure z programu Windows PowerShell.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

Remove-AzureEnvironment
      -Name <String>
      [-Force]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzureEnvironment usuwa środowisko platformy Azure z profilu mobilnego, aby program Windows PowerShell nie mógł go znaleźć. To polecenie cmdlet nie usuwa środowiska z platformy Microsoft Azure ani w żaden sposób zmienia rzeczywiste środowisko.

Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack.

Przykłady

Przykład 1. Usuwanie środowiska

PS C:\> Remove-AzureEnvironment -Name ContosoEnv

To polecenie usuwa środowisko ContosoEnv z programu Windows PowerShell.

Przykład 2. Usuwanie wielu środowisk

PS C:\> Get-AzureEnvironment | Where-Object EnvironmentName -like "Contoso*" | ForEach-Object {Remove-AzureEnvironment -Name $_.EnvironmentName }

To polecenie usuwa środowiska, których nazwy zaczynają się od "Contoso" z programu Windows PowerShell.

Parametry

-Force

Pomija monit o potwierdzenie.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę środowiska do usunięcia. Ten parametr jest wymagany. Ta wartość parametru jest uwzględniana w wielkości liter. Symbole wieloznaczne nie są dozwolone.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.

Dane wyjściowe

None or System.Boolean

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca wartość logiczną. W przeciwnym razie nie zwraca żadnych danych wyjściowych.