Connect-SPOService
將 SharePoint Online 管理員或 SharePoint Embedded 管理員連線到 SharePoint Online 連線 (SharePoint Online 管理中心) 。 必須先執行此 Cmdlet，才能執行任何其他 SharePoint Online Cmdlet。
語法
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>]
Description
Cmdlet 會 Connect-SPOService 將 SharePoint Online 系統管理員或 SharePoint Embedded 系統管理員連線到 SharePoint Online 系統管理中心。
任何單一 Windows PowerShell 會話只會維護單一 SharePoint Online 服務連線。
換句話說，這是組織管理員連線內的每個地理位置。
執行 Cmdlet 兩次會 Connect-SPOService 隱含地中斷先前的連線。
Windows PowerShell 工作階段將設定為為指定的新 SharePoint Online 系統管理員提供服務。
委派的合作夥伴系統管理員必須在相同的 Windows PowerShell 會話中交換不同組織的連線。
您必須是 SharePoint Online 系統管理員或 SharePoint Embedded 系統管理員，才能執行 Cmdlet。
如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊，請參閱位於 SharePoint Online Management Shell 簡介的線上文件。
範例
範例 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
使用 MSAL) (Microsoft 驗證程式庫進行驗證，並在驗證成功時連線到 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
使用應用程式身分識別和憑證檔案路徑，以及選擇性密碼，連線到 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"
使用應用程式身分識別和憑證指紋連線到 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
使用應用程式身分識別和憑證物件連線到 SharePoint Online 服務。
參數
-AuthenticationUrl
適用：SharePoint Online
Microsoft Entra 跨租用戶驗證服務的位置。 如果使用非預設的跨租用戶驗證服務，則可以選擇性地使用。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationUrl
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Certificate
適用：SharePoint Online
驗證期間使用的 X.509 憑證。
參數屬性
| 類型: | X509Certificate2 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificatePassword
適用：SharePoint Online
憑證檔案的密碼。
參數屬性
| 類型: | SecureString |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificatePath
適用：SharePoint Online
本機 .pfx 憑證檔案的路徑。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificateThumbprint
適用：SharePoint Online
目前使用者憑證存放區中憑證的指紋。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ClientId
適用：SharePoint Online
應用程式的用戶端識別碼。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ApplicationID |
參數集
AuthenticationCertificate
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ClientTag
適用：SharePoint Online
允許將用戶端標籤附加至現有的用戶端標籤。 選擇性地在 CSOM http 流量中使用，以識別已使用的腳本或解決方案。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
適用：SharePoint Online
指定要用來連線的認證。 如果未提供認證，則會提示對話方塊輸入認證。 認證必須是可存取 SharePoint Online 管理中心網站的 SharePoint Online 系統管理員的認證。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationUrl
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AuthenticationLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ModernAuth
適用：SharePoint Online
確保 SharePoint Online 租用戶管理 Cmdlet 可以使用新式 TLS 通訊協定連線到服務。
若要使用它，您也需要提供 AuthenticationUrl 參數。
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationUrl
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AuthenticationLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Region
適用：SharePoint Online
有效值為：預設值 |國際塔爾 |德國 |中國
預設值為「預設」。
注意：ITAR值僅適用於GCC High和DoD租用戶。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AuthenticationCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TenantId
適用：SharePoint Online
要連線的租用戶識別碼。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationCertificate
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Url
適用：SharePoint Online
指定 SharePoint Online 管理中心網站的 URL。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseSystemBrowser
適用：SharePoint Online
用來使用 MSAL) (Microsoft驗證程式庫來驗證使用者。
注意事項
若要避免每次執行 Connect-SPOService時新增-UseSystemBrowser參數，您可以改為設定登錄機碼。
將登錄 UseSystemBrowser 機碼 (類型 REG_DWORD) 設定在： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
如果任一登錄機碼設定為非零整數值，或 -UseSystemBrowser 參數設定為 true，驗證流程會使用系統瀏覽器進行登入。
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AuthenticationUrl
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AuthenticationLocation
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。