Connect-SPOService
Подключает администратора SharePoint Online или администратора SharePoint Embedded к подключению 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 Embedded к Центру администрирования SharePoint Online.
Из любого сеанса Windows PowerShell поддерживается только одно подключение к службе SharePoint Online.
Другими словами, это отдельный регион в пределах подключения администратора организации.
Выполнение командлета Connect-SPOService дважды неявно отключает предыдущее подключение.
Сеанс Windows PowerShell будет настроен для обслуживания нового указанного администратора SharePoint Online.
Делегированный администратор партнера должен переключать подключения для разных организаций в рамках одного Windows PowerShell сеанса.
Для выполнения командлета необходимо быть администратором SharePoint Online или администратором SharePoint Embedded.
Сведения о разрешениях и самую последнюю информацию о Windows PowerShell для SharePoint Online см. в электронной документации Знакомство с командной консолью SharePoint Online.
Примеры
ПРИМЕР 1
Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential [email protected]
В примере 1 показано, как администратор SharePoint Online с учетными данными [email protected] подключается к Центру администрирования SharePoint Online с URL-адресом <https://contoso-admin.sharepoint.com.>
ПРИМЕР 2
$username = "[email protected]"
$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 с именем пользователя и паролем подключается к Центру администрирования SharePoint Online с URL-адресом. <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
Подключение к службе SPO с помощью флага ModernAuth.
ПРИМЕР 6
Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true
Выполняет проверку подлинности с помощью библиотеки проверки подлинности Майкрософт (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
Подключитесь к службе 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationUrl
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Certificate
Применимо: SharePoint Online
Сертификат X.509, используемый во время проверки подлинности.
Свойства параметров
| Тип: | X509Certificate2 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationCertificate
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CertificatePassword
Применимо: SharePoint Online
Пароль для файла сертификата.
Свойства параметров
| Тип: | SecureString |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationCertificate
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CertificatePath
Применимо: SharePoint Online
Путь к локальному PFX-файлу сертификата.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationCertificate
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CertificateThumbprint
Применимо: SharePoint Online
Отпечаток сертификата в хранилище сертификатов текущего пользователя.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationCertificate
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ClientId
Применимо: SharePoint Online
Идентификатор клиента приложения.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | ApplicationId |
Наборы параметров
AuthenticationCertificate
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ClientTag
Применимо: SharePoint Online
Разрешает добавление тега клиента к существующему тегу клиента. При необходимости используется в HTTP-трафике CSOM для идентификации используемого скрипта или решения.
Свойства параметров
| Тип: | System.String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Применимо: SharePoint Online
Задает учетные данные для соединения. Если учетные данные не указаны, появится диалоговое окно, где их можно будет ввести. Учетные данные должны быть учетными данными администратора SharePoint Online, который может получить доступ к сайту Центра администрирования SharePoint Online.
Свойства параметров
| Тип: | Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationUrl
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
AuthenticationLocation
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModernAuth
Применимо: SharePoint Online
Гарантирует, что командлеты администрирования клиента SharePoint Online могут подключаться к службе с помощью современных протоколов TLS.
Чтобы использовать его, необходимо также указать параметр AuthenticationUrl .
Свойства параметров
| Тип: | System.Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationUrl
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
AuthenticationLocation
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Region
Применимо: SharePoint Online
Допустимые значения: По умолчанию | ITAR | Германия | Китай
Значение по умолчанию — default.
Примечание. Значение ITAR предназначено только для арендаторов GCC High и DoD.
Свойства параметров
| Тип: | Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationLocation
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
AuthenticationCertificate
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TenantId
Применимо: SharePoint Online
Идентификатор клиента для подключения.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationCertificate
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Url
Применимо: SharePoint Online
Указывает URL-адрес сайта Центра администрирования SharePoint Online.
Свойства параметров
| Тип: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UseSystemBrowser
Применимо: SharePoint Online
Используется для проверки подлинности пользователя с помощью библиотеки проверки подлинности Майкрософт (MSAL).
Примечание.
Чтобы избежать добавления -UseSystemBrowser параметра при каждом запуске Connect-SPOService, вместо этого можно задать раздел реестра.
UseSystemBrowser Задайте раздел реестра (тип REG_DWORD) в:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
Если для любого раздела реестра задано ненулевое целочисленное значение или -UseSystemBrowser параметр имеет значение true, поток проверки подлинности будет использовать системный браузер для входа.
Свойства параметров
| Тип: | System.Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthenticationUrl
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
AuthenticationLocation
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.