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

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

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

まず、PowerShell で管理モードで次SharePointコマンドを実行して、オンライン管理シェルを既にインストール済みか確認できます。

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

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

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

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

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

使用可能なすべてのコマンドレットを確実に使用するには、常にモジュールが最新の情報に更新されている必要があります。 管理モードで次のSharePointを実行すると、オンライン管理シェルを更新できます。

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

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

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

  1. [オンライン管理シェル] コマンド プロンプトでSharePointコマンドを実行します。

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

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

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

  1. [オンライン管理シェル] コマンド プロンプトでSharePointコマンドを実行します。

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

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

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

注意

  • MFA を使用して接続する際に問題が発生した場合は、「オンライン管理シェル」の「Connect-SPOService コマンドレットを使用SharePointモダン認証を強制できません」を参照してください

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

  • オンライン環境の領域を指定するSharePoint場合は、-Region パラメーターを使用します。詳細については、「Connect-SPOService」のドキュメントを参照してください。