Connect-SPOService

Connect-SPOService
    [-Url] <UrlCmdletPipeBind>
    [[-ClientTag] <String>]
    -ClientId <String>
    -TenantId <String>
    [-Region <AADCrossTenantAuthenticationLocation>]
    [-AuthenticationUrl <String>]
    [-Certificate <X509Certificate2>]
    [-CertificatePath <String>]
    [-CertificateThumbprint <String>]
    [-CertificatePassword <SecureString>]
    [<CommonParameters>]

Connect-SPOService
    [-Url] <UrlCmdletPipeBind>
    [[-Credential] <CredentialCmdletPipeBind>]
    [[-ClientTag] <String>]
    [[-ModernAuth] <Boolean>]
    [[-UseSystemBrowser] <Boolean>]
    [-Region <AADCrossTenantAuthenticationLocation>]
    [<CommonParameters>]

Connect-SPOService
    -Url <UrlCmdletPipeBind>
    [-ClientTag <String>]
    [-ManagedIdentity]
    [-ManagedIdentityType <ManagedIdentityType>]
    [-ManagedIdentityClientId <String>]
    [<CommonParameters>]

Connect-SPOService
    [-Url] <UrlCmdletPipeBind>
    [[-Credential] <CredentialCmdletPipeBind>]
    [[-ClientTag] <String>]
    [[-ModernAuth] <Boolean>]
    [[-UseSystemBrowser] <Boolean>]
    -AuthenticationUrl <String>
    [<CommonParameters>]

Этот командлет подключает администратора SharePoint или администратора SharePoint Embedded к Центру администрирования SharePoint. Для каждого сеанса Windows PowerShell и географического расположения в организации поддерживается только одно подключение к службе SharePoint Online. При повторном запуске этого командлета существующее подключение автоматически отключается и заменяется новым. Затем в сеансе PowerShell используется новый контекст администратора. Делегированные администраторы партнеров должны переключать подключения при управлении несколькими организациями в рамках одного сеанса PowerShell. Для запуска этого командлета у вас должны быть права администратора SharePoint или администратора SharePoint Embedded. Требования к разрешениям и последние рекомендации см. во введении в документацию по командной консоли SharePoint Online.

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com

В этом примере показано, как администратор SharePoint с помощью учетной admin@contoso.com записи подключается к Центру администрирования SharePoint по адресу https://contoso-admin.sharepoint.com.

$username = "admin@contoso.sharepoint.com"
$password = Read-Host -Prompt "Enter user password" -AsSecureString
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $userName, $password
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred

В этом примере показано, как администратор SharePoint подключается к Центру администрирования SharePoint путем https://contoso-admin.sharepoint.com создания объекта учетных данных из имени пользователя и пароля.

Connect-SPOService -Url https://contoso-admin.sharepoint.com

В этом примере запрашиваются учетные данные. Этот подход необходим, когда учетная запись использует многофакторную проверку подлинности.

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR

В этом примере указывается регион проверки подлинности для подключения к Центру администрирования SharePoint.

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

В этом примере подключение к Центру администрирования SharePoint выполняется с помощью современной проверки подлинности.

Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true

В этом примере проверка подлинности выполняется с помощью библиотеки проверки подлинности Майкрософт (MSAL) и подключение к Центру администрирования SharePoint после успешной проверки подлинности.

$password = Read-Host -Prompt "Enter certificate password" -AsSecureString
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password

В этом примере подключение к Центру администрирования SharePoint осуществляется с помощью удостоверения приложения и пути к файлу сертификата, а также необязательного пароля сертификата.

Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"

В этом примере подключение к Центру администрирования SharePoint осуществляется с помощью удостоверения приложения и отпечатка сертификата.

$thumbprint = "3F2A5C9D4E7B8A1234567890ABCDEF1234567890"
$cert = Get-ChildItem Cert:\LocalMachine\My\$thumbprint
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -Certificate $cert

В этом примере подключение к Центру администрирования SharePoint осуществляется с помощью удостоверения приложения и объекта сертификата.

Connect-SPOService -Url https://contoso-admin.sharepoint.com -ManagedIdentity

В этом примере подключение к Центру администрирования SharePoint осуществляется с помощью назначенного системой управляемого удостоверения.

Connect-SPOService -url https://contoso-admin.sharepoint.com -ManagedIdentity -ManagedIdentityType UserAssigned -ManagedIdentityClientId 00000000-0000-0000-0000-000000000000

В этом примере подключение к Центру администрирования SharePoint осуществляется с помощью назначенного пользователю управляемого удостоверения.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.