Connect-SPOService
SharePoint Online 管理者または SharePoint 埋め込み管理者を SharePoint Online 接続 (SharePoint Online 管理センター) に接続します。 このコマンドレットは、他の SharePoint Online コマンドレットを実行する前に実行する必要があります。
構文
AuthenticationCertificate
Connect-SPOService
-Url <UrlCmdletPipeBind>
-ClientId <String>
-TenantId <String>
[-ClientTag <String>]
[-Region <AADCrossTenantAuthenticationLocation>]
[-AuthenticationUrl <String>]
[-Certificate <X509Certificate2>]
[-CertificatePath <String>]
[-CertificateThumbprint <String>]
[-CertificatePassword <SecureString>]
[<CommonParameters>]
AuthenticationLocation
Connect-SPOService
-Url <UrlCmdletPipeBind>
[-Credential <CredentialCmdletPipeBind>]
[-ClientTag <String>]
[-Region <AADCrossTenantAuthenticationLocation>]
[-ModernAuth <Boolean>]
[-UseSystemBrowser <Boolean>]
[<CommonParameters>]
AuthenticationUrl
Connect-SPOService
-Url <UrlCmdletPipeBind>
-AuthenticationUrl <String>
[-Credential <CredentialCmdletPipeBind>]
[-ClientTag <String>]
[-ModernAuth <Boolean>]
[-UseSystemBrowser <Boolean>]
[<CommonParameters>]
説明
Connect-SPOService コマンドレットは、SharePoint Online 管理者または SharePoint 埋め込み管理者を SharePoint Online 管理センターに接続します。
単一のWindows PowerShell セッションから保持されるのは、1 つの SharePoint Online サービス接続のみです。
つまり、これは、organization管理者接続内の geo 単位です。
Connect-SPOService コマンドレットを 2 回実行すると、以前の接続が暗黙的に切断されます。
Windows PowerShell セッションは、指定された新しい SharePoint Online 管理者にサービスを提供するように設定されます。
委任されたパートナー管理者は、同じWindows PowerShell セッション内の異なる組織の接続を交換する必要があります。
コマンドレットを実行するには、SharePoint Online 管理者または SharePoint Embedded 管理者である必要があります。
SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。
例
例 1
Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com
例 1 は、資格情報 admin@contoso.com を持つ SharePoint Online 管理者が、URL を持つ SharePoint Online 管理センターに接続する方法を示しています <https://contoso-admin.sharepoint.com.>
例 2
$username = "admin@contoso.sharepoint.com"
$password = "password"
$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $Password -asplaintext -force)
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred
例 2 は、ユーザー名とパスワードを持つ SharePoint Online 管理者が、URL を持つ SharePoint Online 管理センターに接続する方法を示しています <https://contoso-admin.sharepoint.com.>
例 3
Connect-SPOService -Url https://contoso-admin.sharepoint.com
資格情報のプロンプト。 これは、アカウントが多要素認証を使用している場合に必要です。
例 4
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR
リージョンを指定して SharePoint Online 管理センターに接続します。
例 5
Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations
ModernAuth フラグを使用して SPO サービスに接続する。
例 6
Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true
Microsoft 認証ライブラリ (MSAL) を使用して認証し、認証が成功したら SharePoint Online 管理センターに接続します。
例 7
$password = Read-Host -Prompt "Enter certificate password" -AsSecureString
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password
オプションのパスワードを使用して、アプリ ID と証明書ファイル パスを使用して SharePoint Online サービスに接続します。
例 8
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
アプリ ID と証明書の拇印を使用して SharePoint Online サービスに接続します。
例 9
$thumbprint = "3F2A5C9D4E7B8A1234567890ABCDEF1234567890"
$cert = Get-ChildItem Cert:\LocalMachine\My\$thumbprint
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -Certificate $cert
アプリ ID と証明書オブジェクトを使用して SharePoint Online サービスに接続します。
パラメーター
-AuthenticationUrl
適用対象: SharePoint Online
テナント間認証サービスMicrosoft Entra場所。 既定以外のテナント間認証サービスを使用する場合は、必要に応じて使用できます。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationUrl
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Certificate
適用対象: SharePoint Online
認証中に使用される X.509 証明書。
パラメーターのプロパティ
| 型: | X509Certificate2 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationCertificate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CertificatePassword
適用対象: SharePoint Online
証明書ファイルのパスワード。
パラメーターのプロパティ
| 型: | SecureString |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationCertificate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CertificatePath
適用対象: SharePoint Online
ローカルの .pfx 証明書ファイルへのパス。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationCertificate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CertificateThumbprint
適用対象: SharePoint Online
現在のユーザーの証明書ストア内の証明書の拇印。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationCertificate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ClientId
適用対象: SharePoint Online
アプリケーションのクライアント ID。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ApplicationId |
パラメーター セット
AuthenticationCertificate
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ClientTag
適用対象: SharePoint Online
既存のクライアント タグにクライアント タグを追加することを許可します。 CSOM http トラフィックで必要に応じて使用され、使用されているスクリプトまたはソリューションを識別します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Credential
適用対象: SharePoint Online
接続に使用する資格情報を指定します。 資格情報が指定されていない場合、資格情報を求めるダイアログが表示されます。 資格情報は、SharePoint Online 管理センター サイトにアクセスできる SharePoint Online 管理者の資格情報である必要があります。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationUrl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AuthenticationLocation
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModernAuth
適用対象: SharePoint Online
SharePoint Online テナント管理コマンドレットが最新の TLS プロトコルを使用してサービスに接続できることを確認します。
これを使用するには、 AuthenticationUrl パラメーターも指定する必要があります。
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationUrl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AuthenticationLocation
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Region
適用対象: SharePoint Online
有効な値は、既定値 |ITAR |ドイツ |中国
既定値は "default" です。
注: ITAR 値は GCC High および DoD テナンシー専用です。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationLocation
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AuthenticationCertificate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TenantId
適用対象: SharePoint Online
接続するテナント ID。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationCertificate
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Url
適用対象: SharePoint Online
SharePoint Online 管理センター サイトの URL を指定します。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UseSystemBrowser
適用対象: SharePoint Online
Microsoft 認証ライブラリ (MSAL) を使用してユーザーを認証するために使用されます。
注:
Connect-SPOServiceを実行するたびに -UseSystemBrowser パラメーターを追加しないようにするには、代わりにレジストリ キーを設定します。
UseSystemBrowser レジストリ キーを設定します (「REG_DWORD」と入力します)。HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
レジストリ キーが 0 以外の整数値に設定されているか、パラメーター -UseSystemBrowser が true に設定されている場合、認証フローはサインインにシステム ブラウザーを使用します。
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AuthenticationUrl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AuthenticationLocation
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。