Connect-ExchangeOnline

이 cmdlet은 Exchange Online PowerShell 모듈에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.

Exchange Online PowerShell 모듈의 Connect-ExchangeOnline cmdlet을 사용하여 최신 인증을 사용하여 Exchange Online PowerShell 또는 독립 실행형 Exchange Online Protection PowerShell에 연결합니다. 이 cmdlet은 MFA(다단계 인증)가 있거나 없는 계정에 대해 작동합니다.

보안 & 준수 PowerShell에 연결하려면 Connect-IPPSSession cmdlet을 사용합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

Connect-ExchangeOnline
       [[-ConnectionUri] <String>]
       [[-AzureADAuthorizationEndpointUri] <String>]
       [[-ExchangeEnvironmentName] <ExchangeEnvironment>]
       [[-PSSessionOption] <PSSessionOption>]
       [[-DelegatedOrganization] <String>]
       [[-Prefix] <String>]
       [[-CommandName] <String[]>]
       [[-FormatTypeName] <String[]>]
       [-AccessToken <String>]
       [-AppId <String>]
       [-BypassMailboxAnchoring]
       [-Certificate <X509Certificate2>]
       [-CertificateFilePath <String>]
       [-CertificatePassword <SecureString>]
       [-CertificateThumbprint <String>]
       [-Credential <PSCredential>]
       [-Device]
       [-EnableErrorReporting]
       [-InlineCredential]
       [-LogDirectoryPath <String>]
       [-LogLevel <LogLevel>]
       [-ManagedIdentity]
       [-ManagedIdentityAccountId <String>]
       [-Organization <String>]
       [-PageSize <UInt32>]
       [-ShowBanner]
       [-ShowProgress <Boolean>]
       [-SigningCertificate <X509Certificate2>]
       [-SkipLoadingFormatData]
       [-TrackPerformance <Boolean>]
       [-UseMultithreading <Boolean>]
       [-UserPrincipalName <String>]
       [-UseRPSSession]
       [<CommonParameters>]

Description

이 cmdlet은 Exchange Online organization 대한 PowerShell 연결을 만듭니다. 이 cmdlet을 사용하여 Exchange Online PowerShell V3 모듈의 REST API 지원 cmdlet 및 모든 기존 Exchange Online PowerShell cmdlet(원격 PowerShell cmdlet)에 대해 인증할 수 있습니다.

연결에 사용한 계정의 프로필 경로에 특수 PowerShell 문자(예 $: )가 포함된 경우 연결 명령이 실패할 수 있습니다. 해결 방법은 프로필 경로에 특수 문자가 없는 다른 계정을 사용하여 연결하는 것입니다.

예제

예 1

Connect-ExchangeOnline -UserPrincipalName chris@contoso.com

이 예제에서는 MFA(다단계 인증)를 사용하거나 사용하지 않고 최신 인증을 사용하여 Exchange Online PowerShell에 연결합니다. UseRPSSession 스위치를 사용하지 않으므로 연결에서 REST를 사용하며 로컬 컴퓨터의 WinRM에서 기본 인증을 사용하도록 설정할 필요가 없습니다.

예 2

Connect-ExchangeOnline -UserPrincipalName chris@contoso.com -UseRPSSession

이 예제에서는 MFA를 사용하거나 사용하지 않고 최신 인증을 사용하여 Exchange Online PowerShell에 연결합니다. UseRPSSession 스위치를 사용하고 있으므로 로컬 컴퓨터의 WinRM에서 기본 인증을 사용하도록 설정해야 합니다.

예 3

Connect-ExchangeOnline -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"

이 예제에서는 인증서 지문을 사용하여 무인 스크립팅 시나리오에서 Exchange Online PowerShell에 연결합니다.

예 4

Connect-ExchangeOnline -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"

이 예제에서는 인증서 파일을 사용하여 무인 스크립팅 시나리오에서 Exchange Online PowerShell에 연결합니다. 이 방법은 인증서가 원격 머신에 저장되고 런타임에 페치되는 시나리오에 가장 적합합니다. 예를 들어 인증서는 Azure Key Vault 저장됩니다.

예 5

Connect-ExchangeOnline -Device

이 예제에서는 모듈 버전 2.0.4 이상을 사용하는 PowerShell 7.0.3 이상에서 웹 브라우저가 없는 컴퓨터의 대화형 스크립팅 시나리오에서 Exchange Online PowerShell에 연결합니다.

이 명령은 세션에 대한 URL 및 고유 코드를 반환합니다. 컴퓨터의 브라우저에서 URL을 연 다음 고유 코드를 입력해야 합니다. 웹 브라우저에서 로그인을 완료하면 Powershell 7 창의 세션이 일반 Azure AD 인증 흐름을 통해 인증됩니다. 몇 초 후에 Exchange Online cmdlet을 가져오게 됩니다.

예 6

Connect-ExchangeOnline -InlineCredential

모듈 버전 2.0.4 이상을 사용하는 PowerShell 7.0.3 이상에서 이 예제에서는 PowerShell 창에서 직접 자격 증명을 전달하여 대화형 스크립팅 시나리오에서 Exchange Online PowerShell에 연결합니다.

매개 변수

-AccessToken

참고: 이 매개 변수는 모듈 버전 3.1.0 이상에서 사용할 수 있습니다.

AccessToken 매개 변수는 ExchangeOnline에 연결하는 데 사용되는 OAuth JSON JWT(웹 토큰)를 지정합니다.

액세스 토큰 유형에 따라 조직, DelegatedOrganization 또는 UserPrincipalName 매개 변수와 함께 이 매개 변수를 사용해야 합니다.

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

-AppId

AppId 매개 변수는 CBA(인증서 기반 인증)에 사용되는 서비스 주체의 애플리케이션 ID를 지정합니다. 유효한 값은 애플리케이션 ID(서비스 주체)의 GUID입니다. 예를 들면 36ee4c6c-0812-40a2-b820-b22ebd02bce3와 같습니다.

자세한 내용은 Exchange Online PowerShell 모듈에서 무인 스크립트에 대한 앱 전용 인증을 참조하세요.

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

-AzureADAuthorizationEndpointUri

참고: ExchangeEnvironmentName 매개 변수를 사용하는 경우 AzureADAuthorizationEndpointUri 또는 ConnectionUri 매개 변수를 사용할 필요가 없습니다.

AzureADAuthorizationEndpointUri 매개 변수는 OAuth2 액세스 토큰을 발급할 수 있는 Azure AD 권한 부여 엔드포인트를 지정합니다. 다음 Exchange Online PowerShell 환경 및 관련 값이 지원됩니다.

  • Microsoft 365 또는 Microsoft 365 GCC: 이 매개 변수를 사용하지 마세요. 필요한 값은 https://login.microsoftonline.com/common이지만 기본값이기도 하므로 이 매개 변수를 사용할 필요가 없습니다.
  • Office 365 독일:https://login.microsoftonline.de/common
  • Microsoft 365 GCC High 또는 Microsoft 365 DoD: https://login.microsoftonline.us/common

UserPrincipalName 매개 변수를 사용하는 경우 일반적으로 필요한 환경에서 MFA 또는 페더레이션된 사용자에 대해 AzureADAuthorizationEndpointUri 매개 변수를 사용할 필요가 없습니다(UserPrincipalName 또는 AzureADAuthorizationEndpointUri가 필요합니다. 둘 다 사용하려면 확인).

참고: MFA 인증 또는 페더레이션 인증은 21Vianet에서 운영하는 Office 365 사용할 수 없습니다.

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

-BypassMailboxAnchoring

BypassMailboxAnchoring 스위치는 사서함 앵커링 힌트의 사용을 무시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-Certificate

Certificate 매개 변수는 CBA(인증서 기반 인증)에 사용되는 인증서를 지정합니다. 유효한 값은 인증서의 X509Certificate2 개체 값입니다.

CertificateFilePath 또는 CertificateThumbprint 매개 변수에는 이 매개 변수를 사용하지 마세요.

CBA에 대한 자세한 내용은 Exchange Online PowerShell 모듈의 무인 스크립트에 대한 앱 전용 인증을 참조하세요.

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

-CertificateFilePath

CertificateFilePath 매개 변수는 CBA에 사용되는 인증서를 지정합니다. 유효한 값은 인증서 파일에 대한 전체 공용 경로입니다. 이 매개 변수와 함께 CertificatePassword 매개 변수를 사용합니다.

인증서 또는 CertificateThumbprint 매개 변수에는 이 매개 변수를 사용하지 마세요.

CBA에 대한 자세한 내용은 Exchange Online PowerShell 모듈의 무인 스크립트에 대한 앱 전용 인증을 참조하세요.

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

-CertificatePassword

CertificatePassword 매개 변수는 CertificateFilePath 매개 변수를 사용하여 CBA에 사용되는 인증서를 식별할 때 인증서 파일을 여는 데 필요한 암호를 지정합니다.

다음 메서드를 이 매개 변수의 값으로 사용할 수 있습니다.

  • (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
  • 이 명령을 실행하기 전에 암호를 변수(예 $password = Read-Host "Enter password" -AsSecureString: )로 저장한 다음 값에 변수($password)를 사용합니다.
  • (Get-Credential).password 이 명령을 실행할 때 암호를 안전하게 입력하라는 메시지가 표시됩니다.

CBA에 대한 자세한 내용은 Exchange Online PowerShell 모듈의 무인 스크립트에 대한 앱 전용 인증을 참조하세요.

참고: ConvertTo-SecureString 명령을 사용하여 인증서의 암호를 로컬로 저장하면 자동화 시나리오에 대한 보안 연결 방법의 목적이 무효화됩니다. Get-Credential 명령을 사용하여 인증서 암호를 안전하게 묻는 메시지를 표시하는 것은 자동화 시나리오에 적합하지 않습니다. 즉, 로컬 인증서를 사용하여 연결하는 자동화 되고 안전한 방법은 없습니다.

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

-CertificateThumbprint

CertificateThumbprint 매개 변수는 CBA에 사용되는 인증서를 지정합니다. 유효한 값은 인증서의 지문 값입니다. 예를 들면 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1와 같습니다.

인증서 또는 CertificateFilePath 매개 변수에는 이 매개 변수를 사용하지 마세요.

참고: CertificateThumbprint 매개 변수는 Microsoft Windows에서만 지원됩니다.

CBA에 대한 자세한 내용은 Exchange Online PowerShell 모듈의 무인 스크립트에 대한 앱 전용 인증을 참조하세요.

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

-CommandName

CommandName 매개 변수는 세션으로 가져올 명령의 쉼표로 구분된 목록을 지정합니다. 특정 cmdlet 집합을 사용하는 애플리케이션 또는 스크립트에 이 매개 변수를 사용합니다. 세션의 cmdlet 수를 줄이면 성능을 개선하고 애플리케이션 또는 스크립트의 메모리 공간을 줄일 수 있습니다.

Type:String[]
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConnectionUri

참고: ExchangeEnvironmentName 매개 변수를 사용하는 경우 AzureADAuthorizationEndpointUri 또는 ConnectionUri 매개 변수를 사용할 필요가 없습니다.

ConnectionUri 매개 변수는 원격 Exchange Online PowerShell 세션에 대한 연결 엔드포인트를 지정합니다. 다음 Exchange Online PowerShell 환경 및 관련 값이 지원됩니다.

  • Microsoft 365 또는 Microsoft 365 GCC: 이 매개 변수를 사용하지 마세요. 필요한 값은 https://outlook.office365.com/powershell-liveid/이지만 기본값이기도 하므로 이 매개 변수를 사용할 필요가 없습니다.
  • Office 365 독일:https://outlook.office.de/PowerShell-LiveID
  • 21Vianet에서 운영하는 Office 365:https://partner.outlook.cn/PowerShell
  • Microsoft 365 GCC High: https://outlook.office365.us/powershell-liveID
  • Microsoft 365 DoD: https://webmail.apps.mil/powershell-liveID
Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Credential

자격 증명 매개 변수는 Exchange Online PowerShell에 연결하는 데 사용되는 사용자 이름과 암호를 지정합니다. 일반적으로는 필요한 권한이 있는 여러 자격 증명을 제공해야 하는 경우나 스크립트를 사용하는 경우 이 매개 변수를 사용합니다. MFA(다단계 인증)를 사용하는 계정에는 이 매개 변수를 사용하지 마세요.

Connect-ExchangeOnline 명령을 실행하기 전에 변수에 사용자 이름과 암호를 저장합니다(예: $UserCredential = Get-Credential). 그런 다음, 이 매개 변수에 변수 이름($UserCredential)을 사용합니다.

Connect-ExchangeOnline 명령이 완료되면 변수의 암호 키가 비워집니다.

인증서 파일의 암호를 지정하려면 이 매개 변수를 사용하지 마세요. 대신 CertificatePassword 매개 변수를 사용합니다.

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

-DelegatedOrganization

DelegatedOrganization 매개 변수는 관리할 고객 organization 지정합니다(예: contosoelectronics.onmicrosoft.com). 이 매개 변수는 고객 organization CSP 프로그램을 통해 위임된 관리에 동의한 경우에만 작동합니다.

성공적으로 인증하면 이 세션의 cmdlet이 고객 organization 매핑되고 이 세션의 모든 작업은 고객 organization 수행됩니다.

참고: 이 매개 변수 값에 위임된 organization 기본 .onmicrosoft.com 도메인을 사용합니다.

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

-Device

참고: 이 매개 변수는 모듈 버전 2.0.4 이상에서 사용할 수 있으며 PowerShell 7에서만 사용할 수 있습니다.

디바이스 스위치는 일반적으로 웹 브라우저가 없는 컴퓨터에서 사용됩니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 URL https://microsoft.com/devicelogin 과 고유한 코드가 포함된 화상 메시지가 표시됩니다. 웹 브라우저 및 인터넷 액세스가 있는 다른 디바이스에서 URL을 열고 고유 코드를 입력한 다음, 후속 페이지에 자격 증명을 입력합니다.

로그인에 성공하면 PowerShell 연결이 계속됩니다.

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

-EnableErrorReporting

EnableErrorReporting 스위치는 오류 보고를 사용하도록 설정할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-ExchangeEnvironmentName

ExchangeEnvironmentName은 Exchange Online 환경을 지정하고 AzureADAuthorizationEndpointUri 및 ConnectionUri 매개 변수를 사용할 필요가 없습니다. 다음 Exchange Online PowerShell 환경이 지원됩니다.

  • Microsoft 365 또는 Microsoft 365 GCC: 이 매개 변수를 사용하지 마세요. 필요한 값은 O365Default이지만 기본값이기도 하므로 이 매개 변수를 사용할 필요가 없습니다.
  • Office 365 독일:O365GermanyCloud
  • 21Vianet에서 운영하는 Office 365:O365China
  • Microsoft 365 GCC High: O365USGovGCCHigh
  • Microsoft 365 DoD: O365USGovDoD
Type:ExchangeEnvironment
Position:2
Default value:O365Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FormatTypeName

FormatTypeName 매개 변수는 cmdlet의 출력 형식을 지정합니다.

Type:String[]
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-InlineCredential

참고: 이 매개 변수는 모듈 버전 2.0.4 이상에서 사용할 수 있으며 PowerShell 7에서만 사용할 수 있습니다.

InlineCredential 스위치는 Windows PowerShell 창에서 자격 증명을 직접 전달할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 자격 증명 매개 변수와 비슷하지만 보안이 추가되었습니다. InlineCredential 스위치는 스크립트에 로컬로 자격 증명을 저장할 필요가 없으며 대화형 PowerShell 세션에서 직접 자격 증명을 입력할 수 있습니다.

이 스위치는 MFA를 사용하는 계정에서 작동하지 않습니다.

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

-LogDirectoryPath

LogDirectoryPath 매개 변수는 로그 파일의 위치를 지정합니다. 기본 위치는 입니다 %TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv.

공백이 포함된 사용자 지정 위치와 파일 이름을 지정하는 경우 값을 따옴표(")로 묶습니다.

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

-LogLevel

LogLevel 매개 변수는 로깅 수준을 지정합니다. 유효한 값은 기본값 및 모두입니다.

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

-ManagedIdentity

ManagedIdentity 스위치는 관리 ID를 사용하여 연결하도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 ID 연결은 현재 다음과 같은 유형의 Azure 리소스에 대해 지원됩니다.

  • runbook Azure Automation
  • Azure 가상 컴퓨터
  • Azure Virtual Machine Scale Sets
  • Azure Functions

조직 매개 변수와 함께 이 스위치를 사용해야 합니다.

사용자가 할당한 관리 ID의 경우 ManagedIdentityAccountId 매개 변수와 함께 이 스위치를 사용해야 합니다.

관리 ID를 사용하여 연결하는 방법에 대한 자세한 내용은 Azure 관리 ID를 사용하여 Exchange Online PowerShell에 연결을 참조하세요.

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

-ManagedIdentityAccountId

ManagedIdentityAccountId 매개 변수는 연결하는 데 사용하는 사용자 할당 관리 ID를 지정합니다. 이 매개 변수의 유효한 값은 Azure에서 사용자가 할당한 관리 ID에 해당하는 서비스 주체의 애플리케이션 ID(GUID)입니다.

조직 매개 변수 및 ManagedIdentity 스위치와 함께 이 매개 변수를 사용해야 합니다.

관리 ID를 사용하여 연결하는 방법에 대한 자세한 내용은 Azure 관리 ID를 사용하여 Exchange Online PowerShell에 연결을 참조하세요.

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

-Organization

조직 매개 변수는 CBA 또는 관리 ID를 사용하여 연결할 때 organization 지정합니다. 이 매개 변수 값에 organization 기본 .onmicrosoft.com 도메인을 사용해야 합니다.

CBA를 사용하여 연결하는 방법에 대한 자세한 내용은 Exchange Online PowerShell 모듈의 무인 스크립트에 대한 앱 전용 인증을 참조하세요.

관리 ID를 사용하여 연결하는 방법에 대한 자세한 내용은 Azure 관리 ID를 사용하여 Exchange Online PowerShell에 연결을 참조하세요.

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

-PageSize

PageSize 매개 변수는 페이지당 최대 항목 수를 지정합니다. 이 매개 변수에는 1에서 1,000 사이의 정수를 입력할 수 있습니다. 기본값은 1,000입니다.

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

-Prefix

접두사 매개 변수는 연결할 때 Exchange Online PowerShell cmdlet의 이름에 추가할 텍스트 값을 지정합니다. 예를 들어 이 매개 변수에 Contoso 값을 사용하면 Get-InboundConnector Get-ContosoInboundConnector 됩니다.

  • 접두사 값은 공백이나 밑줄 또는 별표와 같은 특수 문자를 포함할 수 없습니다.
  • 접두사 값 EXO를 사용할 수 없습니다. 이 값은 모듈에 기본 제공되는 9개의 전용 Get-EXO* cmdlet에 대해 예약됩니다.
  • Prefix 매개 변수는 가져온 Exchange Online cmdlet 이름에만 영향을 줍니다. 모듈에 기본 제공되는 cmdlet의 이름(예: Disconnect-ExchangeOnline)에는 영향을 주지 않습니다.
Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PSSessionOption

PSSessionOption 매개 변수는 Exchange Online 연결에 사용할 PowerShell 세션 옵션을 지정합니다. 이 매개 변수는 동일한 명령에서 UseRPSSession 스위치를 사용하는 경우에만 작동합니다.

New-PSSessionOption 명령의 출력을 변수(예: $PSOptions = New-PSSessionOption <Settings>)에 저장하고 변수 이름을 이 매개 변수의 값으로 사용합니다(예$PSOptions: ).

Type:PSSessionOption
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShowBanner

ShowBanner 스위치는 Connect-ExchangeOnline을 실행할 때 표시되는 배너 메시지를 표시하거나 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

  • 배너를 표시하려면 이 스위치를 사용할 필요가 없습니다(배너는 기본적으로 표시됨).
  • 배너를 숨기려면 정확한 구문 -ShowBanner:$false인 를 사용합니다.
Type:SwitchParameter
Position:Named
Default value:$true
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShowProgress

ShowProgress 매개 변수는 연결할 때 가져온 cmdlet의 진행률 표시줄을 표시하거나 숨길지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 진행률 표시줄이 표시됩니다. 이 값은 기본값입니다.
  • $false: 현재 이 값은 영향을 주지 않습니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SigningCertificate

참고: 이 매개 변수는 모듈 버전 3.2.0 이상에서 사용할 수 있습니다.

SigningCertificate 매개 변수는 형식 파일(*)에 서명하는 데 사용되는 클라이언트 인증서를 지정합니다. Connect-ExchangeOnline 만드는 임시 모듈의 Format.ps1xml) 또는 스크립트 모듈 파일(.psm1)입니다.

이 매개 변수의 유효한 값은 인증서를 포함하는 변수 또는 인증서를 가져오는 명령 또는 식입니다.

인증서를 찾으려면 Microsoft.PowerShell.Security 모듈에서 Get-PfxCertificate cmdlet을 사용하거나 인증서(Cert:)에서 Get-ChildItem cmdlet을 사용합니다. 드라이브. 인증서가 유효하지 않거나 충분한 권한이 없는 경우 명령이 실패합니다.

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

-SkipLoadingFormatData

SkipLoadingFormatData 스위치는 REST API 연결에 대한 형식 데이터를 다운로드하지 않습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 Exchange cmdlet의 출력에 서식이 지정되지 않습니다.

이 스위치는 UseRPSSession 스위치에서 작동하지 않습니다.

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

-TrackPerformance

TrackPerformance 매개 변수는 추가 이벤트(예: CPU 로드 및 사용된 메모리)를 측정합니다. 유효한 값은 다음과 같습니다.

  • $true: 성능 추적이 사용됩니다.
  • $false: 성능 추적을 사용할 수 없습니다. 이 값은 기본값입니다.

이 매개 변수는 로깅이 사용하도록 설정된 경우에만 작동합니다.

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

-UseMultithreading

UseMultithreading 매개 변수는 Exchange Online PowerShell 모듈에서 다중 스레딩을 사용하지 않도록 설정할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 다중 스레딩을 사용하도록 설정합니다. 이 값은 기본값입니다.
  • $false: 다중 스레딩을 사용하지 않도록 설정합니다. 이 값은 모듈에서 9개의 전용 Get-EXO* cmdlet의 성능을 저하합니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

UserPrincipalName 매개 변수는 연결하는 데 사용할 계정(예 navin@contoso.onmicrosoft.com: )을 지정합니다. 이 매개 변수를 사용하면 최신 인증 자격 증명 프롬프트에서 사용자 이름 입력을 건너뛸 수 있습니다(암호를 입력하라는 메시지가 표시됨).

UserPrincipalName 매개 변수를 사용하는 경우 일반적으로 필요한 환경에서 MFA 또는 페더레이션된 사용자에 대해 AzureADAuthorizationEndpointUri 매개 변수를 사용할 필요가 없습니다(UserPrincipalName 또는 AzureADAuthorizationEndpointUri가 필요합니다. 둘 다 사용하려면 확인).

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

-UseRPSSession

UseRPSSession 스위치를 사용하면 기존의 원격 PowerShell 액세스를 사용하여 모든 cmdlet에 Exchange Online PowerShell에 연결할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하려면 로컬 컴퓨터의 WinRM에서 기본 인증을 사용하도록 설정해야 합니다. 자세한 내용은 WinRM에서 기본 인증 켜기를 참조하세요.

이 스위치를 사용하지 않으면 WinRM의 기본 인증이 필요하지 않습니다.

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