SharePoint Online 管理シェルを使用して作業を開始する

PowerShell を使用して SharePoint Online を管理するには、SharePoint Online 管理シェルをインストールし、SharePoint Online に接続する必要があります。

SharePoint Online 管理シェルをインストールするには SharePoint Online 管理シェルをダウンロードして実行するか、または PowerShell ギャラリーからモジュールをインストールします。 インストールが完了すると、モジュールが使用できるようになり、新しいバージョンの機能が必要になるまでインストールする必要はありません。 たとえば、2018 年 10 月以降に、TLS 1.2 ネゴシエーション用の新しいバージョンをインストールすることが必要になる場合があります。

最初に、PowerShell で管理モードで次のコマンドを実行して、SharePoint Online Management Shell が既にインストールされているかどうかを確認できます。

Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version

オペレーティング システムで PowerShell 5 以降を使用している場合は、管理モードで次のコマンドを実行して SharePoint Online Management Shell をインストールすることもできます。

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

システムに対する管理者特権がない場合は、次のコマンドを実行して、現在のユーザーに対してのみ SharePoint Online Management Shell をインストールできます。

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser

使用可能なすべてのコマンドレットを確実に使用するには、モジュールが最新であることを常に確認する必要があります。 SharePoint Online Management Shell を更新するには、管理モードで次のコマンドを実行します。

Update-Module -Name Microsoft.Online.SharePoint.PowerShell

SharePoint Online 管理シェルコマンドプロンプトを開くには、[のスタート] 画面で sharepoint を入力し、[SharePoint Online 管理シェル をクリックします。

ユーザー名とパスワードを使用して接続する場合

  1. SharePoint Online Management Shell コマンド プロンプトで次のコマンドを実行します。

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
    
  2. [Windows PowerShell 資格情報の要求] ダイアログ ボックスに指示に従い、SharePoint 管理者アカウントのパスワードを入力します。

SharePoint 管理者ロールをユーザーに割り当てるには、「管理者 ロールの割り当て 」または「 PowerShell を使用して Microsoft 365 ユーザー アカウントに管理者ロールを割り当てる」を参照してください。

注意

接続しようとしている問題や、"エラー メッセージ: SharePoint Online に接続できませんでした"などのエラーが発生した場合は、モダン認証を使用する必要がある場合があります。 次の例を参照してください。

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

多要素認証 (MFA) を使用して接続するには

  1. SharePoint Online Management Shell コマンド プロンプトで次のコマンドを実行します。

    Connect-SPOService -Url https://contoso-admin.sharepoint.com
    
  2. [Microsoft SharePoint Online Management Shell] ダイアログ ボックスが表示されたら、SharePoint 管理者アカウントのアカウント名とパスワードを入力してから、[サインイン] をクリックします。

  3. [Microsoft SharePoint Online Management Shell] ダイアログ ボックスの手順に従って、検証コードなどの他の認証情報を提供してから、[サインイン] をクリックします。

これで SharePoint Online のコマンドを使用できるようになりました。

注意

SharePoint Online Management Shell モジュールと SharePoint クライアント コンポーネント SDK の間には既知の問題があり、両方が同じコンピューターにインストールされている場合、モジュールの読み込みに失敗します。 この問題が発生した場合は、SharePoint クライアント コンポーネント SDK をアンインストールします。