Azure PowerShell モジュールのアンインストール

[アーティクル]
04/30/2024

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断とリスクに委ねられます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

この記事では、古いバージョンの Azure PowerShell をアンインストールする (システムから完全に削除する) 方法について説明します。 Azure PowerShell を完全にアンインストールすることにした場合は、Send-Feedback コマンドレットを使用してフィードバックをお送りください。バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

Azure PowerShell MSI のアンインストール

MSI パッケージを使用して Azure PowerShell をインストールした場合は、PowerShell ではなく Windows システムからアンインストールする必要があります。

プラットフォーム	Instructions
Windows 10	[スタート] > [設定] > [アプリ]
Windows 7 Windows 8	[スタート] > [コントロールパネル] > [プログラム] > [プログラムのアンインストール]

この画面のプログラムの一覧に [Azure PowerShell] が表示されます。これが、アンインストール対象のアプリです。

PowerShell からのアンインストール

PowerShellGet を使用して Azure PowerShell をインストールした場合は、Uninstall-Module コマンドレットを使用します。ただし、Uninstall-Module でアンインストールされるモジュールは 1 つだけです。 Azure PowerShell を完全に削除するには、各モジュールを個別にアンインストールする必要があります。複数のバージョンの Azure PowerShell がインストールされている場合、アンインストールが複雑になることがあります。

現在インストールされている Azure PowerShell のバージョンを確認するには、次のコマンドを実行します。

Get-InstalledModule -Name AzureRM -AllVersions

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
6.11.0               AzureRM                             PSGallery            Azure Resource Manager Module
6.13.1               AzureRM                             PSGallery            Azure Resource Manager Module

次のスクリプトでは、PowerShell ギャラリーに照会して依存サブモジュールの一覧を取得します。次に、各サブモジュールの適切なバージョンがアンインストールされます。 Process または CurrentUser 以外のスコープでこのスクリプトを実行するには、管理者アクセス権が必要です。

function Uninstall-AllModules {
  param(
    [Parameter(Mandatory=$true)]
    [string]$TargetModule,

    [Parameter(Mandatory=$true)]
    [string]$Version,

    [switch]$Force,

    [switch]$WhatIf
  )

  $AllModules = @()

  'Creating list of dependencies...'
  $target = Find-Module $TargetModule -RequiredVersion $version
  $target.Dependencies | ForEach-Object {
    if ($_.PSObject.Properties.Name -contains 'requiredVersion') {
      $AllModules += New-Object -TypeName psobject -Property @{name=$_.name; version=$_.requiredVersion}
    }
    else { # Assume minimum version
      # Minimum version actually reports the installed dependency
      # which is used, not the actual "minimum dependency." Check to
      # see if the requested version was installed as a dependency earlier.
      $candidate = Get-InstalledModule $_.name -RequiredVersion $version -ErrorAction Ignore
      if ($candidate) {
        $AllModules += New-Object -TypeName psobject -Property @{name=$_.name; version=$version}
      }
      else {
        $availableModules = Get-InstalledModule $_.name -AllVersions
        Write-Warning ("Could not find uninstall candidate for {0}:{1} - module may require manual uninstall. Available versions are: {2}" -f $_.name,$version,($availableModules.Version -join ', '))
      }
    }
  }
  $AllModules += New-Object -TypeName psobject -Property @{name=$TargetModule; version=$Version}

  foreach ($module in $AllModules) {
    Write-Host ('Uninstalling {0} version {1}...' -f $module.name,$module.version)
    try {
      Uninstall-Module -Name $module.name -RequiredVersion $module.version -Force:$Force -ErrorAction Stop -WhatIf:$WhatIf
    } catch {
      Write-Host ("`t" + $_.Exception.Message)
    }
  }
}

この関数を使用するには、コードをコピーして PowerShell セッションに貼り付けます。次の例は、関数を実行して古いバージョンの Azure PowerShell を削除する方法を示しています。

Uninstall-AllModules -TargetModule AzureRM -Version 4.4.1 -Force

スクリプトを実行すると、アンインストールされる各サブモジュールの名前とバージョンが表示されます。スクリプトを実行して削除対象を削除せずに表示のみを行うには、-WhatIf オプションを使用します。

Creating list of dependencies...
Uninstalling AzureRM.Profile version 3.4.1
Uninstalling Azure.Storage version 3.4.1
Uninstalling AzureRM.AnalysisServices version 0.4.7
Uninstalling Azure.AnalysisServices version 0.4.7
...

注意

このスクリプトは、アンインストールするのと同じバージョンの依存関係を正確に突き合わせることができない場合、その依存関係の "どの" バージョンもアンインストールしません。これは、これらの依存関係に依存する他のバージョンのターゲットモジュールがシステム上に存在する可能性があるためです。この場合、依存関係の使用可能なバージョンが一覧表示されます。その後、Uninstall-Module を使用して任意の古いバージョンを手動で削除できます。

アンインストールする Azure PowerShell のバージョンごとにこのコマンドを実行します。便宜上、次のスクリプトにより、最新バージョンを除く、AzureRM のすべてのバージョンがアンインストールされます。

$versions = (Get-InstalledModule -Name AzureRM -AllVersions | Select-Object -Property Version)
$versions[0..($versions.Length-2)]  | foreach { Uninstall-AllModules -TargetModule AzureRM -Version ($_.Version) -Force }

Azure PowerShell モジュールのアンインストール

Azure PowerShell MSI のアンインストール

PowerShell からのアンインストール

その他のリソース