Azure Active Directory (MSOnline)
Azure AD および MSOnline PowerShell モジュールは、2024 年 3 月 30 日の時点で非推奨とされます。 詳細については、 非推奨の更新プログラムに関するページを参照してください。 この日以降、これらのモジュールのサポートは、Microsoft Graph PowerShell SDK とセキュリティ修正プログラムへの移行支援に限定されます。 非推奨のモジュールは、2025 年 3 月 30 日まで引き続き機能します。
Microsoft Entra ID (旧称 Azure AD) と対話するには、Microsoft Graph PowerShell に移行することをお勧めします。 移行に関する一般的な質問については、移行に関する FAQ を参照してください。 メモ： MSOnline のバージョン 1.0.x では、2024 年 6 月 30 日以降に中断が発生する可能性があります。
MSOnline は、ユーザー管理、ドメイン管理などの Azure AD 管理タスクやシングル サインオンの構成に使用できます。 このトピックでは、これらのコマンドレットをインストールしてご利用のディレクトリで使う方法について取り上げます。
MSOnline をインストールする
MSonline は、Microsoft .NET Framework と Windows PowerShell の既定のバージョンを持つ次の Windows オペレーティング システムでサポートされています: Windows 8.1、Windows 8、Windows 7、Windows Server 2012 R2、Windows Server 2012、または Windows Server 2008 R2。
モジュールをインストールする最も簡単な方法は、PowerShell ギャラリーから行う方法です。 このモジュールは、Install-Module コマンドレットでインストールすることができます。
Install-Module MSOnline
Azure への接続
この記事で取り上げたコマンドレットを実行する前にまず、ご利用のオンライン サービスに接続する必要があります。 Windows PowerShell コマンド プロンプトから Connect-MsolService コマンドレットを実行してください。 すると、資格情報の入力を求められます。 資格情報は、必要に応じて事前に指定することもできます。その例を次に示します。
$Msolcred = Get-credential
Connect-MsolService -Credential $MsolCred
最初のコマンドは資格情報の入力を求め、 $Msolcredとして格納します。 次のコマンドでは、これらの資格情報を $Msolcred として使用してサービスに接続します。
Azure Active Directory の特定の環境に接続するには、次のように AzureEnvironment パラメーターを使用します。
Connect-MsolService -AzureEnvironment "AzureGermanyCloud"
この例では、PowerShell セッションを German AzureAD 環境に接続しています。
詳しくは、「Connect-MsolService」をご覧ください。
コマンドレットについてさらに詳しい情報を入手するには、次の操作を実行してください。
- ヘルプ用のフォルダーを作成して一連のコマンドレットをファイルに出力し、それをメモ帳で開くには、Windows PowerShell のコマンド プロンプトから次のコマンドを実行します。
New-Item c:\MsolHelp -Type directory
Get-command | Where-Object {$_.name -like "*msol*"} | Format-List | Out-File c:\MsolHelp\msolcmdlets.txt
Notepad c:\MsolHelp\msolcmdlets.txt
コマンドレットの例を確認するには、Windows PowerShell のコマンド プロンプトから次のコマンドを実行します。
Get-Help <cmdlet-name> -Examplesコマンドレットの名前、概要、説明、パラメーターの解説、使用例を確認するには、Windows PowerShell のコマンド プロンプトから次のコマンドを実行します。
Get-Help <cmdlet-name> -Detailedコマンドレットの名前、概要、説明、パラメーターの詳細な解説、使用例を確認するには、Windows PowerShell のコマンド プロンプトから次のコマンドを実行します。
Get-Help <cmdlet-name> -Full