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 |