Connect-SPOService

  • 참조
모듈:
Microsoft.Online.SharePoint.PowerShell
적용 대상:
SharePoint Online

SharePoint Online 관리자 또는 전역 관리자를 SharePoint Online 연결(SharePoint Online 관리 센터)에 연결합니다. 다른 SharePoint Online cmdlet을 실행하려면 먼저 이 cmdlet을 실행해야 합니다.

Syntax

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

Description

cmdlet은 Connect-SPOService SharePoint Online 관리자 또는 전역 관리자를 SharePoint Online 관리 센터에 연결합니다.

단일 Windows PowerShell 세션에서는 단일 SharePoint Online 서비스 연결만 유지 관리됩니다. 즉, 조직 관리자 연결 내의 지역별 연결입니다. cmdlet을 Connect-SPOService 두 번 실행하면 이전 연결의 연결이 암시적으로 끊어집니다. Windows PowerShell 세션은 지정된 새 SharePoint Online 관리자에게 제공되도록 설정됩니다.

위임된 파트너 관리자는 동일한 Windows PowerShell 세션 내의 여러 조직에 대한 연결을 교환해야 합니다.

cmdlet을 실행하려면 SharePoint Online 관리자 또는 전역 관리자 역할이 있어야 합니다.

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 서비스에 연결

매개 변수

-AuthenticationUrl

AAD 테넌트 간 인증 서비스의 위치입니다. 기본값이 아닌 테넌트 간 인증 서비스를 사용하는 경우 필요에 따라 사용할 수 있습니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ClientTag

기존 클라이언트 태그에 클라이언트 태그를 추가할 수 있습니다. CSOM http 트래픽에서 선택적으로 사용하여 사용된 스크립트 또는 솔루션을 식별합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Credential

연결에 사용할 자격 증명을 지정합니다. 자격 증명을 지정하지 않으면 자격 증명을 묻는 대화 상자가 나타납니다. 자격 증명은 SharePoint Online 관리 센터 사이트에 액세스할 수 있는 SharePoint Online 관리자 또는 전역 관리자의 자격 증명이어야 합니다.

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-ModernAuth

SharePoint Online 테넌트 관리 cmdlet이 최신 TLS 프로토콜을 사용하여 서비스에 연결할 수 있는지 확인합니다.

이 매개 변수를 사용하려면 AuthenticationUrl 매개 변수도 제공해야 합니다.

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Region

유효한 값은 기본값 | ITAR | 독일 | 중국

기본값은 "default"입니다.

참고: ITAR 값은 GCC High 및 DoD 테넌시에만 해당됩니다.

Type:AADCrossTenantAuthenticationLocation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Url

SharePoint Online 관리 센터 사이트의 URL을 지정합니다.

Type:UrlCmdletPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online