SharePoint Online 管理シェルの使用を開始する

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

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

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

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

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

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

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

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

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

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 を使用して 365 ユーザー アカウントMicrosoft管理者ロールを割り当てる」を参照してください。

注:

"エラー メッセージ: 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 をアンインストールします。