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 管理シェルをクリックします。
ユーザー名とパスワードを使用して接続する場合
SharePoint Online Management Shell コマンド プロンプトで次のコマンドを実行します。
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com[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) を使用して接続するには
SharePoint Online Management Shell コマンド プロンプトで次のコマンドを実行します。
Connect-SPOService -Url https://contoso-admin.sharepoint.com[Microsoft SharePoint Online Management Shell] ダイアログ ボックスが表示されたら、SharePoint 管理者アカウントのアカウント名とパスワードを入力してから、[サインイン] をクリックします。
[Microsoft SharePoint Online Management Shell] ダイアログ ボックスの手順に従って、検証コードなどの他の認証情報を提供してから、[サインイン] をクリックします。
これで SharePoint Online のコマンドを使用できるようになりました。
注:
SharePoint Online Management Shell モジュールと SharePoint クライアント コンポーネント SDK の間には、両方が同じコンピューターにインストールされている場合にモジュールの読み込みに失敗する既知の問題があります。 この問題が発生した場合は、SharePoint クライアント コンポーネント SDK をアンインストールします。