Connect-SPOService
SharePoint Online 관리자 또는 SharePoint Embedded 관리자를 SharePoint Online 연결(SharePoint Online 관리 센터)에 연결합니다. 다른 SharePoint Online cmdlet을 실행하려면 먼저 이 cmdlet을 실행해야 합니다.
구문
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 서비스 연결만 유지 관리됩니다.
즉, 이는 organization 관리자 연결 내의 지역별 연결입니다.
cmdlet을 Connect-SPOService 두 번 실행하면 이전 연결의 연결이 암시적으로 끊어집니다.
Windows PowerShell 세션은 지정된 새 SharePoint Online 관리자에게 제공되도록 설정됩니다.
위임된 파트너 관리자는 동일한 Windows PowerShell 세션 내의 여러 조직에 대한 연결을 교환해야 합니다.
cmdlet을 실행하려면 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
MSAL(Microsoft 인증 라이브러리)을 사용하여 인증하고 성공적인 인증을 위해 SharePoint Online 관리 센터에 연결합니다.
매개 변수
-AuthenticationUrl
적용 가능: SharePoint Online
Microsoft Entra 테넌트 간 인증 서비스의 위치입니다. 기본값이 아닌 테넌트 간 인증 서비스를 사용하는 경우 필요에 따라 사용할 수 있습니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AuthenticationUrl
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ClientTag
적용 가능: SharePoint Online
기존 클라이언트 태그에 클라이언트 태그를 추가할 수 있습니다. CSOM http 트래픽에서 선택적으로 사용하여 사용된 스크립트 또는 솔루션을 식별합니다.
매개 변수 속성
| 형식: | 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 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ModernAuth
적용 가능: SharePoint Online
SharePoint Online 테넌트 관리 cmdlet이 최신 TLS 프로토콜을 사용하여 서비스에 연결할 수 있는지 확인합니다.
이 매개 변수를 사용하려면 AuthenticationUrl 매개 변수도 제공해야 합니다.
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| 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 |
-Url
적용 가능: SharePoint Online
SharePoint Online 관리 센터 사이트의 URL을 지정합니다.
매개 변수 속성
| 형식: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UseSystemBrowser
적용 가능: SharePoint Online
MSAL(Microsoft 인증 라이브러리)을 사용하여 사용자를 인증하는 데 사용됩니다.
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.