JML IA-Connect
IA-Connect 클라우드에서 온-프레미스 가상 머신 또는 Citrix 또는 Microsoft 원격 데스크톱 'RDS' 연결을 통해 RPA 기능을 추가하는 로봇 프로세스 자동화 'RPA' 플랫폼입니다. 조인자, Mover, Leaver 프로세스를 자동화하기 위한 모듈입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| 전자 메일 | IAConnect@ultima.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Ultima Business |
| 웹 사이트 | https://www.ultima.com/ultima-labs |
| 개인 정보 보호 정책 | https://www.ultima.com/privacy-policy |
| 카테고리 | IT 작업; 생산력 |
IA-Connect Power Automate Cloud Flows의 RPA 기능을 온-프레미스 가상 머신 또는 Citrix 또는 RDS(Microsoft Remote Desktop) 연결을 통해 RPA 기능을 추가하는 RPA(로봇 프로세스 자동화) 플랫폼입니다. IA-Connect 커넥터는 800개 이상의 작업을 제공하므로 Power Automate 클라우드 흐름에서 직접 모든 유형의 온-프레미스 애플리케이션을 자동화할 수 있습니다. 모든 IA-Connect 작업은 Power Automate Cloud Flow에서 직접 사용할 수 있으며, 클라우드 기반 애플리케이션과 온-프레미스 애플리케이션 간에 쉽게 통합할 수 있으며, RPA 프로세스에서 기존 Power Automate 조건, 루프, 동적 콘텐츠, 식 및 예외 처리를 활용할 수 있습니다. IA-Connect 커넥터를 활용하면 흐름 실행 기록의 전체 실행 기록 및 감사 가능성도 제공하는 동시에 RPA 프로세스를 개발하기 위한 별도의 애플리케이션/콘솔/스튜디오가 필요하지 않습니다.
필수 조건
IA-Connect 커넥터를 사용하려면 IA-Connect 소프트웨어를 설치해야 합니다. 30일 동안 무료로 테스트할 수 있으며, IA-Connect 라이선스가 필요합니다.
IA-Connect 소프트웨어는 다음 두 가지 주요 구성 요소로 구성됩니다.
IA-Connect Orchestrator는 사용자 고유의 Azure 테넌트에서 호스트할 Azure WebApp입니다. 이는 하나 이상의 온-프레미스 또는 클라우드 기반 가상 머신에 대한 RPA 흐름의 라우팅 및 보안을 처리합니다.
자동화하려는 소프트웨어에 액세스할 수 있는 가상 머신에 설치된 IA-Connect 에이전트 및 디렉터입니다. 또한 IA-Connect 에이전트는 Citrix 또는 Microsoft RDS(원격 데스크톱 서비스) 세션 내에서 실행할 수 있습니다. 여기서 RPA 명령은 실행을 위해 가상 채널을 원격 세션으로 전달합니다. IA-Connect 에이전트는 네트워크 공유에서 실행할 수 있으며 설치가 필요하지 않습니다.
사용 가능한 IA-Connect 커넥터
사용 가능한 IA-Connect 커넥터는 다음과 같습니다.
- 동적 코드 IA-Connect
- java IA-Connect
- JML IA-Connect
- IA-Connect 메인프레임
- Microsoft Office IA-Connect
- SAP GUI IA-Connect
- IA-Connect 세션
- IA-Connect UI
- IA-Connect 웹 브라우저
자격 증명을 가져오는 방법
라이선스를 받고 30일 무료 평가판을 시작하려면 웹 사이트(https://www.ultima.com/IA-Connect/Power-Automate)에 요청을 제출하세요.
평가판 요청이 수신되면 IA-Connect 소프트웨어 설정을 지원하고 평가판 라이선스를 제공하기 위해 제공된 이메일 주소를 통해 연락을 드립니다. 이 평가판은 완전한 기능을 갖춘 평가판이며 평가 기간 동안 사용자 환경 내의 모든 9개 IA-Connect 커넥터에서 800개의 작업을 테스트할 수 있습니다.
커넥터 시작
IA-Connect에 대한 평가판 요청을 제출한 후에는 설치 및 설치를 다루는 IA-Connect 소프트웨어 및 설명서가 포함된 ZIP 파일을 다운로드할 수 있습니다. 또한 필요에 따라 설치 프로세스를 통해 지원 및 지침을 제공하기 위해 연락을 드립니다.
Support
평가 기간 동안 Ultima Labs(IAConnect@ultima.com)에 문의하여 지원 및 지원을 받을 수 있습니다.
IA-Connect 라이선스를 구매하면 Ultima의 영국 기반 TSC(기술 서비스 센터)에서 맞춤형 교육 또는 지원을 위해 사용할 수 있는 지원 토큰을 받게 됩니다.
알려진 문제, 일반적인 오류 및 FAQ
기술 자료에는 알려진 문제, IA-Connect 커넥터를 사용할 때 발생할 수 있는 일반적인 오류 및 질문과 대답을 다루는 여러 문서가 포함되어 있습니다. 이 기능은 액세스할 https://support.ultima.com/ultimalabs 수 있으며 IA-Connect 평가판 및 IA-Connect 라이선스 구매 시 이러한 리소스에 액세스할 수 있는 계정이 제공됩니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | 진실 |
| IA-Connect Orchestrator 주소 | 문자열 | HTTP(S) 구성 요소 없이 IA-Connect Orchestrator 주소 지정 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
|
Active Directory Dir |
Active Directory(온-프레미스)와 Azure Active Directory(클라우드) 간의 동기화를 수행합니다. 이 명령은 'DirSync' 역할(즉, 동기화를 수행하는 컴퓨터)을 사용하여 서버에 발급되어야 합니다. |
| Active Directory OU 제거 |
Active Directory에서 OU(조직 구성 단위)를 제거합니다. OU에 개체(예: 사용자, 그룹 또는 컴퓨터)가 있는 경우 OU를 삭제할 수 없습니다. |
| Active Directory OU 추가 |
새 OU(Active Directory 조직 구성 단위)를 만듭니다. |
| Active Directory OU가 있는지 확인 |
OU(Active Directory 조직 구성 단위)가 있는지 보고합니다. |
|
Active Directory Power |
IA-Connect 에이전트가 실행되는 세션의 Active Directory Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 지정 Active Directory PowerShell 코드를 실행하는 데 권장되는 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. |
| Active Directory 계정 잠금 해제 |
Active Directory 계정의 잠금을 해제합니다. 계정이 잠겨 있지 않으면 이 명령은 아무 작업도 수행하지 않습니다. |
| Active Directory 그룹 가져오기 |
지정된 Active Directory 그룹 또는 그룹의 속성을 반환합니다. ID(단일 그룹 찾기) 또는 필터(하나 이상의 그룹 찾기)를 사용하여 검색할 수 있습니다. |
| Active Directory 그룹 구성원 가져오기 |
Active Directory 그룹의 멤버 목록을 반환합니다. |
| Active Directory 그룹 구성원 제거 |
Active Directory 그룹에서 Active Directory 멤버(사용자, 그룹 또는 컴퓨터)를 제거합니다. |
| Active Directory 그룹 구성원 추가 |
기존 Active Directory 그룹에 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 추가합니다. 그룹 및 그룹 멤버가 서로 다른 도메인에 있는 경우 그룹 및 멤버 모두에 대해 DN(고유 이름)을 지정해야 합니다. |
| Active Directory 그룹 제거 |
Active Directory에서 그룹을 제거합니다. 그룹에 개체(예: 사용자, 그룹 또는 컴퓨터)가 있는 경우 해당 개체는 그룹 삭제의 일부로 제거됩니다. |
| Active Directory 그룹 추가 |
새 Active Directory 그룹을 만듭니다. |
| Active Directory 그룹이 존재하나요? |
지정된 Active Directory 그룹이 있는지 여부를 반환합니다. |
| Active Directory 도메인 정보 가져오기 |
Active Directory 도메인에 대한 정보를 검색합니다. |
| Active Directory 사용자 가져오기 |
지정된 Active Directory 사용자의 속성을 반환합니다. ID(단일 사용자 찾기) 또는 필터(하나 이상의 사용자 찾기)를 사용하여 검색할 수 있습니다. |
| Active Directory 사용자 계정 만료 날짜 설정 |
Active Directory 사용자 계정의 계정 만료 날짜를 설정합니다. 이 날짜는 계정을 사용할 수 있는 마지막 하루 종일이므로 기술적으로는 다음 날 시작 시 계정이 만료됩니다. IA-Connect 에이전트는 이를 인식하고 Active Directory에 날짜를 저장할 때 제공된 입력 날짜에 1일을 자동으로 추가합니다. |
| Active Directory 사용자 계정 만료 지우기 |
Active Directory 계정의 만료 날짜를 지웁니다. |
| Active Directory 사용자 계정 사용 |
Active Directory 사용자 계정을 사용하도록 설정합니다. 계정을 사용하지 않도록 설정하지 않으면 이 명령은 아무 작업도 수행하지 않습니다. |
| Active Directory 사용자 계정 사용 안 함 |
Active Directory 사용자 계정을 사용하지 않도록 설정합니다. 사용자 계정을 사용하지 않도록 설정하면 사용자가 로그온할 수 없습니다. |
| Active Directory 사용자 그룹 멤버 자격 가져오기 |
지정된 사용자가 멤버로 속해 있는 Active Directory 그룹 목록을 반환하며, 기술적으로 멤버 자격이 아니므로 기본 그룹(일반적으로 '도메인 사용자')을 뺀 값입니다. 이 작업은 사용자 계정에서만 작동하므로 이 작업을 사용하여 그룹 또는 컴퓨터의 그룹 멤버 자격을 쿼리할 수 없습니다. |
| Active Directory 사용자 그룹 멤버 자격 복제 |
대상 Active Directory 사용자를 첫 번째 사용자가 멤버로 속해 있는 동일한 Active Directory 그룹에 추가하고, 기술적으로 멤버 자격이 아니므로 기본 그룹(일반적으로 '도메인 사용자')을 뺀 값입니다. |
| Active Directory 사용자 문자열 속성 수정 |
Active Directory 사용자의 개별 문자열 속성을 수정합니다. 이렇게 하면 사용자 지정 속성을 포함하여 매우 구체적인 사용자 설정을 수정할 수 있습니다. 개별 사용자 속성을 비워 둘 수도 있습니다. |
| Active Directory 사용자 부울 속성 수정 |
Active Directory 사용자의 개별 부울(true/false) 속성을 수정합니다. 이렇게 하면 사용자 지정 속성을 포함하여 매우 구체적인 사용자 설정을 수정할 수 있습니다. |
| Active Directory 사용자 속성 복제 |
원본 Active Directory 사용자의 지정된 속성/특성을 대상 Active Directory 사용자로 구성합니다. |
| Active Directory 사용자 암호 다시 설정 |
새 암호로 Active Directory 사용자의 암호를 다시 설정하고 필요에 따라 암호 속성을 설정합니다. |
| Active Directory 사용자 제거 |
Active Directory에서 사용자를 제거합니다. |
| Active Directory 사용자 추가 |
새 Active Directory 사용자 계정을 만듭니다. |
| Active Directory 사용자 홈 폴더 수정 |
Active Directory 사용자의 홈 폴더/디렉터리/드라이브를 설정합니다. |
| Active Directory 사용자를 OU로 이동 |
Active Directory 사용자를 기존 OU(Active Directory 조직 구성 단위)로 이동합니다. |
| Active Directory 서버 설정 |
모든 추가 Active Directory 작업에 사용할 특정 Active Directory 서버를 설정합니다. |
| Active Directory 일반 사용자 속성 수정 |
Active Directory 사용자의 공통 속성을 수정합니다. 속성에만 값을 할당할 수 있으며 값을 공백으로 설정할 수는 없습니다. 속성을 비워 두려면 'Active Directory 사용자 문자열 속성 수정' 작업을 사용합니다. |
| Active Directory에 연결됨 |
IA-Connect Active Directory에 연결되어 있는지 보고합니다. 기본적으로 IA-Connect IA-Connect 에이전트가 실행 중인 계정을 사용하여 IA-Connect 에이전트를 실행하는 컴퓨터가 구성원인 도메인에 자동으로 연결됩니다. '자격 증명을 사용하여 Active Directory에 연결' 작업을 사용하여 대체 자격 증명을 사용하거나 대체 도메인에 연결합니다. |
| Active Directory에서 연결 끊기 |
'자격 증명으로 Active Directory PowerShell Runspace 열기' 작업을 사용하여 Active Directory PowerShell 명령을 대체 사용자 계정 또는 대체 도메인으로 실행한 경우 이 작업은 IA-Connect 에이전트가 실행 중인 사용자 계정으로 Active Directory 작업을 실행하는 기본 동작으로 IA-Connect 에이전트를 반환합니다. |
|
Azure AD Power |
Azure Active Directory에 필요한 PowerShell 모듈(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)이 IA-Connect 에이전트가 실행 중인 컴퓨터에 설치되어 있는지 보고합니다. 이 작업은 Azure AD v2 및 Microsoft Graph 사용자 PowerShell 모듈을 확인합니다. |
|
Azure AD Power |
IA-Connect 에이전트가 실행되는 세션에서 Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함) Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 지정 Azure AD PowerShell 스크립트를 실행하기 위한 권장 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. 이 작업은 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 그룹 가져오기 |
Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에서 그룹의 세부 정보를 반환합니다. 개체 ID 또는 필터를 사용하여 검색할 수 있습니다. 개체 ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 그룹 구성원 가져오기 |
Azure Active Directory 그룹의 멤버 목록을 반환합니다. 멤버는 사용자, 그룹, 디바이스 또는 서비스 주체/엔터프라이즈 애플리케이션일 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 라이선스 SKU 가져오기 |
연결된 Azure AD가 구독하는 Azure Active Directory SKU(Stock Keeping Units) 목록을 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 보안 또는 Microsoft 365 그룹 제거 |
Azure Active Directory 보안 그룹 또는 Microsoft 365 그룹을 제거합니다. 이 작업은 메일 사용 보안 그룹 또는 메일 그룹을 제거할 수 없습니다. 대신 'Office 365 메일 그룹 제거' 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 가져오기 |
Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에서 사용자의 세부 정보를 반환합니다. 개체 ID 또는 필터를 사용하여 검색할 수 있습니다. 개체 ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 관리자 역할 할당 가져오기 |
지정된 사용자가 할당된 Azure Active Directory 관리자 역할 목록을 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 그룹 멤버 자격 가져오기 |
지정된 사용자가 구성원인 Azure Active Directory 그룹 목록을 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 그룹의 사용자인가요? |
사용자가 Azure Active Directory 그룹의 구성원인지 여부를 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 라이선스 가져오기 |
Azure AD 사용자에게 할당된 라이선스 목록(SKU)을 검색합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 라이선스 서비스 계획 가져오기 |
지정된 Azure AD SKU(사용자 라이선스)에 할당된 라이선스 계획 목록을 검색합니다. 예를 들어 사용자에게 FLOW_FREE 라이선스가 할당된 경우 해당 라이선스에 프로비전한 서비스 계획을 볼 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 라이선스 설정 |
Azure AD SKU(사용자 라이선스)를 추가하거나 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 사용 |
Azure Active Directory 사용자를 사용하도록 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 사용 안 함 |
Azure Active Directory 사용자를 사용하지 않도록 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 속성 다시 설정 |
Azure Active Directory 사용자의 공통 속성을 빈 값으로 다시 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 속성 수정 |
Azure Active Directory 사용자의 공통 속성을 수정합니다. 빈 값은 값을 변경하지 않고 그대로 두려는 의도로 해석되므로 속성에만 값을 할당하고 값을 비워 두지 않을 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 암호 다시 설정 |
새 암호를 사용하여 Azure Active Directory 사용자의 암호를 다시 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 제거 |
Azure Active Directory 사용자를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자 추가 |
새 Azure Active Directory 사용자 계정을 만듭니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자가 관리자 역할에 할당되어 있나요? |
Azure Active Directory 사용자가 Azure Active Directory 관리자 역할에 할당되었는지 여부를 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD 사용자의 관리자 설정 |
Azure Active Directory 사용자의 관리자를 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| Azure AD에 연결됨 |
IA-Connect Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에 연결되어 있는지 보고합니다. 'Azure AD에 연결' 작업 중 하나를 사용하여 연결합니다. |
| Azure AD에서 연결 끊기 |
Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에서 IA-Connect 연결을 끊습니다. 다시 연결할 때까지 Azure AD 작업을 다시 실행할 수 없습니다. 이 작업은 원래 연결하는 데 사용되었던 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| DN에서 Active Directory 도메인 FQDN 가져오기 |
유틸리티 함수입니다. Active Directory 사용자의 DN(고유 이름)이 지정된 경우 사용자가 포함된 Active Directory 도메인을 반환합니다. |
|
Exchange Power |
IA-Connect 에이전트가 실행되는 세션의 Exchange Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 고유의 사용자 지정 Exchange PowerShell 코드를 실행하는 데 권장되는 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. |
| Exchange를 설정하여 전체 Active Directory 포리스트 보기 |
Exchange 작업을 수행할 때 전체 Active Directory 포리스트(하위 도메인 포함)를 검색/볼지 여부를 지정합니다. 연결된 도메인이 여러개 있는 경우 이 작업을 사용해야 할 수 있습니다. |
| JML 환경에 연결 |
해당 환경의 세부 정보가 IA-Connect Orchestrator에서 유지되는 JML 환경에 연결합니다. 이러한 세부 정보에는 자격 증명, 주소 및 기타 연결 설정이 포함될 수 있습니다. 예를 들어 이 작업을 사용하여 Active Directory, Microsoft Exchange, Azure AD 또는 Office 365 Exchange Online에 연결할 수 있습니다. |
| Microsoft Exchange Online 사서함 및 사용자 계정 만들기 |
온-프레미스 Active Directory에서 메일 사용 가능 사용자를 만들고 Microsoft Exchange Online 또는 Office 365에서 연결된 원격 사서함을 만듭니다. 사용자가 온-프레미스 Active Directory에 없는 경우에만 이 작업을 사용합니다. 사용자가 이미 있는 경우 '사용자에 대한 Microsoft Exchange Online 사서함 만들기' 작업을 사용합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| Microsoft Exchange Online 사서함 세부 정보 검색 |
지정한 Microsoft Exchange Online 또는 Office 365(원격) 사서함의 속성을 반환합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. |
| Microsoft Exchange Online 사서함 전자 메일 주소 검색 |
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함에 할당된 모든 전자 메일 주소 목록을 검색합니다. 여기에는 기본 SMTP 주소, 프록시 전자 메일 주소, X.400 주소 및 EUM(Exchange 통합 메시징) 주소가 포함됩니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| Microsoft Exchange Online 사서함 전자 메일 주소 수정 |
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함에서 전자 메일 주소를 수정합니다. 기본 및 별칭 전자 메일 주소를 추가, 제거 및 바꿀 수 있습니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| Microsoft Exchange Online 사서함의 속성 다시 설정 |
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함의 지정된 속성을 공백으로 설정합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| Microsoft Exchange Online 사서함의 속성 설정 |
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함의 속성을 설정합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| Microsoft Exchange Online 사서함이 있나요? |
지정한 Microsoft Exchange Online 또는 Office 365(원격) 사서함이 있는지 여부를 반환합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| Microsoft Exchange 메일 그룹 구성원 가져오기 |
Microsoft Exchange 메일 그룹의 구성원 목록을 검색합니다. |
| Microsoft Exchange 메일 그룹 세부 정보 검색 |
Microsoft Exchange 메일 그룹의 세부 정보를 검색합니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. |
| Microsoft Exchange 메일 그룹 제거 |
Microsoft Exchange 메일 그룹을 제거합니다. |
| Microsoft Exchange 사서함 권한 추가 |
Active Directory 개체(예: 사용자 또는 그룹)에 사서함 권한을 할당합니다. |
| Microsoft Exchange 사서함 메일 그룹 멤버 자격 검색 |
사서함이 구성원인 메일 그룹을 검색합니다. |
| Microsoft Exchange 사서함 및 사용자 계정 만들기 |
온-프레미스 Active Directory에서 메일 사용 가능 사용자를 만들고 Microsoft Exchange에서 연결된 사서함을 만듭니다. 사용자가 온-프레미스 Active Directory에 없는 경우에만 이 작업을 사용합니다. 사용자가 이미 있는 경우 '사용자에 대한 Microsoft Exchange 사서함 만들기' 작업을 사용합니다. |
| Microsoft Exchange 사서함 세부 정보 검색 |
지정된 Exchange 사서함의 속성을 반환합니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. |
| Microsoft Exchange 사서함 전자 메일 주소 검색 |
Microsoft Exchange 사서함에 할당된 모든 전자 메일 주소 목록을 검색합니다. 여기에는 기본 SMTP 주소, 프록시 전자 메일 주소, X.400 주소 및 EUM(Exchange 통합 메시징) 주소가 포함됩니다. |
| Microsoft Exchange 사서함 전자 메일 주소 수정 |
Microsoft Exchange 사서함의 전자 메일 주소를 수정합니다. 기본 및 별칭 전자 메일 주소를 추가, 제거 및 바꿀 수 있습니다. |
| Microsoft Exchange 사서함에 대한 자동 회신(부재 중) 설정 |
Microsoft Exchange 사서함에 대한 자동 회신(부재 중)을 설정합니다. 이 작업은 Microsoft Exchange Online 또는 Office 365의 원격 사서함에서 작동하지 않습니다. 대신 'Office 365 사서함에 대해 자동 회신 설정(부재 중)' 작업을 사용합니다. |
| Microsoft Exchange 사서함의 속성 다시 설정 |
기존 Microsoft Exchange 사서함의 지정된 속성을 비워 둠으로 설정합니다. |
| Microsoft Exchange 사서함의 속성 설정 |
기존 Microsoft Exchange 사서함의 속성을 설정합니다. |
| Microsoft Exchange 사서함이 있나요? |
지정된 Exchange 사서함이 있는지 여부를 반환합니다. |
| Microsoft Exchange에 연결 |
microsoft Exchange 서버에 IA-Connect 연결합니다. 다른 Exchange 작업을 실행하기 전에 이 작업을 실행해야 합니다. 사용자 이름과 암호를 지정하면 모든 후속 Exchange 작업이 해당 계정으로 실행됩니다. 사용자 이름 및 암호를 지정하지 않으면 모든 후속 Exchange 작업은 IA-Connect 에이전트가 실행 중인 사용자 계정으로 실행됩니다. |
| Microsoft Exchange에 연결됨 |
IA-Connect Microsoft Exchange 서버에 연결되어 있는지 보고합니다. 'Microsoft Exchange에 연결' 작업을 사용하여 연결합니다. |
| Microsoft Exchange에서 연결 끊기 |
Microsoft Exchange 서버에서 IA-Connect 연결을 끊습니다('Microsoft Exchange에 연결' 작업을 사용하여 연결됨). 다시 연결할 때까지 Microsoft Exchange PowerShell 작업을 다시 실행할 수 없습니다. |
|
Office 365 Power |
IA-Connect 에이전트가 실행되는 세션의 Office 365 Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 지정 Office 365 Exchange Online PowerShell 코드를 실행하기 위한 권장 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. |
| Office 365 공유 사서함 및 사용자 계정 만들기 |
Microsoft Exchange Online에서 공유 사서함을 만들고 Azure Active Directory/Entra ID에서 사용자 계정을 만듭니다. 사용자가 Azure Active Directory/Entra ID에 아직 없는 경우에만 이 작업을 사용합니다. 공유 사서함 SMTP 주소는 이름, 별칭 또는 기본 SMTP 주소(제공된 입력에 따라 다름)를 기반으로 합니다. |
| Office 365 메일 그룹 가져오기 |
지정한 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹의 속성을 반환합니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. |
| Office 365 메일 그룹 구성원 가져오기 |
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹의 구성원 목록을 검색합니다. |
| Office 365 메일 그룹 제거 |
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 가능 보안 그룹을 제거합니다. |
| Office 365 사서함 가져오기 |
지정한 Microsoft Exchange Online 또는 Office 365 사서함의 속성을 반환합니다. |
| Office 365 사서함 대기 |
지정된 Microsoft Exchange Online 또는 Office 365 사서함이 존재할 때까지 기다립니다. 이는 AD 동기화 또는 라이선스 설정이 적용되기를 기다리는 경우에 일반적입니다. 사서함이 이미 있는 경우 작업은 즉시 성공적으로 반환됩니다. |
| Office 365 사서함 메일 그룹 멤버 자격 검색 |
Office 365 또는 Exchange Online 사서함이 구성원인 메일 그룹 또는 메일 사용 가능 보안 그룹을 검색합니다. |
| Office 365 사서함 및 사용자 계정 만들기 |
Microsoft Exchange Online에서 사서함을 만들고 Azure Active Directory/Entra ID에서 사용자 계정을 만듭니다. 사용자가 Azure Active Directory/Entra ID에 아직 없는 경우에만 이 작업을 사용합니다. 사용자가 이미 있는 경우 사용자 계정에 적절한 라이선스를 할당합니다. |
| Office 365 사서함에 대한 자동 회신(부재 중) 설정 |
Microsoft Exchange Online 또는 Office 365 사서함에 대한 자동 회신(부재 중)을 설정합니다. |
| Office 365 사서함에 보관 파일이 있나요? |
Microsoft Exchange Online의 기존 사서함에 보관 사서함이 있는지 여부를 보고합니다. 사서함이 없으면 예외가 발생합니다. |
| Office 365 사서함의 속성 설정 |
Microsoft Exchange Online 또는 Office 365 사서함에서 속성을 설정합니다. |
| Office 365에 연결됨 |
IA-Connect Office 365 PowerShell 모듈을 사용하여 Office 365에 연결되어 있는지 보고합니다. 'Office 365에 연결' 작업을 사용하여 연결합니다. |
| Office 365에서 연결 끊기 |
Office 365 PowerShell 모듈을 사용하여 Office 365에서 IA-Connect 연결을 끊습니다('Office 365에 연결' 작업을 사용하여 연결됨). 다시 연결할 때까지 Office 365 PowerShell 작업을 다시 실행할 수 없습니다. |
| 관리자 역할 할당에서 Azure AD 사용자 제거 |
기존 Azure Active Directory 관리자 역할 할당에서 Azure Active Directory 사용자(또는 다른 개체)를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 관리자 역할에 Azure AD 사용자 할당 |
기존 Azure Active Directory 관리자 역할에 Azure Active Directory 사용자(또는 다른 개체)를 할당합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 그룹에 Azure AD 사용자 추가 |
기존 Azure Active Directory 보안 또는 M365 그룹에 Azure Active Directory 사용자를 추가합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 그룹에서 Azure AD 사용자 제거 |
Azure Active Directory 그룹에서 Azure Active Directory 사용자를 제거합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 기본 Active Directory 도메인에 연결 |
IA-Connect 에이전트가 실행 중인 계정(즉, 기본 동작)을 사용하여 IA-Connect 에이전트를 실행하는 컴퓨터가 구성원인 도메인에 IA-Connect 에이전트를 연결합니다. |
| 기존 사용자에 대한 Office 365 보관 사서함 만들기 |
Azure Active Directory/Entra ID의 기존 사용자에 대해 Microsoft Exchange Online에 보관된 사서함을 만듭니다. 사용자에게 사서함 및 적절한 라이선스가 이미 있어야 합니다. |
| 를 대신하여 Exchange 사서함 보내기 설정 |
이 기존 사서함을 대신하여 보낼 수 있는 사용자를 지정합니다. |
| 메일 그룹에 Microsoft Exchange 멤버 추가 |
Exchange 메일 그룹에 멤버(예: 사용자)를 추가합니다. 멤버가 이미 그룹에 있는 경우 아무 작업도 수행되지 않습니다. |
| 메일 그룹에 Office 365 구성원 추가 |
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹에 구성원을 추가합니다. |
| 메일 그룹에서 Microsoft Exchange 멤버 제거 |
Exchange 메일 그룹에서 멤버(예: 사용자)를 제거합니다. 멤버가 그룹에 없는 경우 아무 작업도 수행되지 않습니다. |
| 메일 그룹에서 Office 365 구성원 제거 |
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹에서 구성원을 제거합니다. |
| 모든 Azure AD 사용자 라이선스 제거 |
사용자에게 할당된 모든 Azure AD SKU(사용자 라이선스)를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 모든 관리자 역할 할당에서 Azure AD 사용자 제거 |
할당된 모든 Azure Active Directory 관리자 역할에서 Azure Active Directory 사용자(또는 다른 개체)를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 모든 그룹에서 Active Directory 사용자 제거 |
구성원인 모든 Active Directory 그룹에서 Active Directory 사용자를 제거합니다. IA-Connect 가능한 한 많은 그룹에서 사용자를 제거하고 결과를 보고합니다. 이 작업은 사용자 계정에서만 작동하므로 이 작업을 사용하여 그룹 또는 컴퓨터의 그룹 멤버 자격을 제거할 수 없습니다. |
| 모든 그룹에서 Azure AD 사용자 제거 |
구성원인 모든 Azure Active Directory 그룹에서 Azure Active Directory 사용자를 제거합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 모든 메일 그룹에서 Office 365 사서함 제거 |
구성원인 모든 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 가능 보안 그룹에서 사서함을 제거합니다. |
| 사용 가능한 다음 계정 이름 가져오기 |
Active Directory 및 Exchange 계정 이름에 대한 명명 형식에 대한 세부 정보가 제공되면 사용 가능한 다음 예비 계정 이름의 세부 정보를 제공합니다. 지정된 사용자에 대해 만들 Active Directory 및 Exchange 계정을 결정하는 데 사용됩니다. 이 작업은 계정을 만들지 않으며 이름 가용성에 대한 정보를 제공합니다. |
| 사용자 DN에서 Active Directory OU 가져오기 |
유틸리티 함수입니다. Active Directory 사용자의 DN(고유 이름)이 지정된 경우 사용자가 있는 OU(조직 구성 단위)를 반환합니다. |
| 사용자로부터 Microsoft Exchange 사서함 권한 제거 |
지정된 사서함 사용자, 사용자 또는 보안 그룹에서 사서함 권한을 제거합니다. |
| 사용자로부터 Office 365 사서함 권한 제거 |
지정된 사서함 사용자, 사용자 또는 보안 그룹에서 Microsoft Exchange Online 또는 Office 365 사서함 권한을 제거합니다. |
| 사용자에 대한 Microsoft Exchange Online 사서함 만들기 |
아직 사서함이 없는 온-프레미스 Active Directory의 기존 사용자에 대한 Microsoft Exchange Online 또는 Office 365(원격) 사서함 또는 보관 사서함을 만듭니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. 이 작업을 사용하여 기존 원격 사서함을 보관할 수도 있습니다. |
| 사용자에 대한 Microsoft Exchange Online 사서함 사용 안 함 |
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 사용하지 않도록 설정합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. |
| 사용자에 대한 Microsoft Exchange 사서함 만들기 |
사서함이 없는 기존 사용자에 대한 Microsoft Exchange 사서함을 만듭니다. |
| 사용자에 대한 Microsoft Exchange 사서함 사용 안 함 |
기존 Microsoft Exchange 사서함을 사용하지 않도록 설정합니다. |
| 사용자에게 Microsoft Exchange 사서함 권한 추가 |
지정된 사서함 사용자, 사용자 또는 보안 그룹에 사서함 권한을 할당합니다. |
| 사용자에게 Office 365 사서함 권한 추가 |
지정된 사서함 사용자, 사용자 또는 보안 그룹에 Microsoft Exchange Online 또는 Office 365 사서함 권한을 할당합니다. |
| 새 Azure AD Microsoft 365 그룹 만들기 |
새 Azure Active Directory Microsoft 365 그룹을 만듭니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 새 Azure AD 보안 그룹 만들기 |
새 Azure Active Directory 보안 그룹을 만듭니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 새 Microsoft Exchange 메일 그룹 만들기 |
새 Microsoft Exchange 메일 그룹 또는 메일 사용 보안 그룹을 만듭니다. |
| 새 Office 365 메일 그룹 만들기 |
새 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 가능 보안 그룹을 만듭니다. |
| 실수로 인한 삭제로부터 보호되는 Active Directory 사용자 설정 |
실수로 삭제되지 않도록 Active Directory 계정을 보호하거나 보호하지 않도록 설정합니다. 실수로 삭제하지 않도록 계정을 보호하는 경우 보호를 제거할 때까지 해당 계정을 삭제할 수 없습니다. |
| 여러 Active Directory 그룹 구성원 제거 |
기존 Active Directory 그룹에서 하나 이상의 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 제거합니다. IA-Connect 그룹에서 가능한 한 많은 멤버를 제거하고 결과를 보고합니다. 그룹 및 그룹 멤버가 서로 다른 도메인에 있는 경우 그룹 및 멤버 모두에 대해 DN(고유 이름)을 지정해야 합니다. 일부 개체가 그룹의 멤버가 아닌 경우 성공으로 계산됩니다. |
| 여러 Active Directory 그룹 구성원 추가 |
하나 이상의 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 기존 Active Directory 그룹에 추가합니다. IA-Connect 가능한 한 많은 멤버를 그룹에 추가하고 결과를 보고합니다. 그룹 및 그룹 멤버가 서로 다른 도메인에 있는 경우 그룹 및 멤버 모두에 대해 DN(고유 이름)을 지정해야 합니다. 일부 개체가 이미 그룹의 멤버인 경우 성공으로 계산됩니다. |
| 여러 관리자 역할에 Azure AD 사용자 할당 |
하나 이상의 기존 Azure Active Directory 관리자 역할에 Azure Active Directory 사용자(또는 다른 개체)를 할당합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 여러 관리자 역할에서 Azure AD 사용자 제거 |
하나 이상의 기존 Azure Active Directory 관리자 역할에서 Azure Active Directory 사용자(또는 다른 개체)를 제거합니다. 이 작업은 사용자의 역할 할당 목록을 반복하고 일치하는 항목을 제거하므로 제거할 존재하지 않는 역할을 지정하는 경우 오류가 트리거되지 않습니다(사용자가 해당 역할에 없으면 아무 시도도 수행되지 않음). 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 여러 그룹에 Active Directory 개체 추가 |
여러 기존 Active Directory 그룹에 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 추가합니다. IA-Connect 가능한 한 많은 그룹에 개체를 추가하고 결과를 보고합니다. 개체가 이미 지정된 그룹 중 하나 이상의 멤버인 경우 성공으로 계산됩니다. |
| 여러 그룹에 Azure AD 사용자 추가 |
개체 ID 또는 표시 이름으로 그룹을 지정하는 여러 기존 Azure Active Directory 그룹에 Azure Active Directory 사용자를 추가합니다. IA-Connect 가능한 한 많은 그룹에 사용자를 추가하고 결과를 보고합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 여러 그룹에서 Active Directory 개체 제거 |
여러 기존 Active Directory 그룹에서 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 제거합니다. IA-Connect 가능한 한 많은 그룹에서 개체를 제거하고 결과를 보고합니다. 개체가 지정된 그룹 중 하나 이상의 멤버가 아닌 경우 성공으로 계산됩니다. |
| 여러 그룹에서 Azure AD 사용자 제거 |
그룹이 개체 ID 또는 표시 이름으로 지정된 여러 기존 Azure Active Directory 그룹에서 Azure Active Directory 사용자를 제거합니다. IA-Connect 가능한 한 많은 그룹에서 사용자를 제거하고 결과를 보고합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 인증서를 사용하여 Azure AD에 연결 |
IA-Connect Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에 연결합니다. 다른 Azure AD 작업을 실행하기 전에 이 작업(또는 '자격 증명을 사용하여 Azure AD에 연결')을 실행해야 합니다. 이 작업을 수행하려면 Azure AD에서 인증서를 사용하여 Azure 서비스 주체 및 Azure AD 앱 등록을 설정해야 작동하지만 MFA(2FA)를 요구하지 않는다는 장점이 있습니다. 이 작업은 Azure AD v2 또는 Microsoft Graph PowerShell 모듈을 사용합니다. |
| 인증서를 사용하여 Office 365에 연결 |
Office 365 PowerShell 모듈을 사용하여 office 365에 IA-Connect 연결합니다. 다른 Office 365 작업을 실행하기 전에 이 작업(또는 '자격 증명으로 Office 365에 연결')을 실행해야 합니다. 이 작업을 수행하려면 Azure AD 앱이 작동하기 전에 인증서를 사용하여 Azure AD 앱을 등록하고 올바른 역할을 설정해야 하지만 MFA(2FA)를 요구하지 않는다는 장점이 있습니다. |
| 자격 증명을 사용하여 Active Directory에 연결 |
Active Directory PowerShell 명령을 실행할 때 사용할 대체 계정을 지정할 수 있습니다. 이 작업은 이 작업 후에 실행된 모든 Active Directory 명령에 영향을 줍니다. 이 작업을 사용하지 않으면 모든 Active Directory PowerShell 명령이 IA-Connect 에이전트가 실행 중인 사용자 계정으로 실행됩니다. |
| 자격 증명을 사용하여 Azure AD에 연결 |
IA-Connect Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에 연결합니다. 다른 Azure AD 작업을 실행하기 전에 이 작업(또는 '인증서를 사용하여 Azure AD에 연결')을 실행해야 합니다. 이 작업을 수행하려면 MFA(2FA)를 사용하지 않는 계정이 필요하거나 UI 자동화 모듈을 사용하여 2FA 구성 요소(즉, 일회성 암호 인증 팝업)를 자동화해야 합니다. 또는 '인증서를 사용하여 Azure AD에 연결' 작업을 사용합니다. 이 작업은 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다. |
| 자격 증명을 사용하여 Office 365에 연결 |
Office 365 PowerShell 모듈을 사용하여 office 365에 IA-Connect 연결합니다. 다른 Office 365 작업을 실행하기 전에 이 작업(또는 '인증서를 사용하여 Office 365에 연결')을 실행해야 합니다. 이 작업을 수행하려면 MFA(2FA)가 필요하지 않은 계정이 필요하거나 UI 자동화 모듈을 사용하여 2FA 구성 요소(즉, 일회성 암호 인증 팝업)를 자동화해야 합니다. 또는 '인증서를 사용하여 Office 365에 연결' 작업을 사용합니다. |
Active Directory DirSync 수행
Active Directory(온-프레미스)와 Azure Active Directory(클라우드) 간의 동기화를 수행합니다. 이 명령은 'DirSync' 역할(즉, 동기화를 수행하는 컴퓨터)을 사용하여 서버에 발급되어야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
정책 유형
|
PolicyType | string |
수행할 동기화의 유형입니다. 옵션은 마지막 동기화(기본 옵션) 이후 변경 내용을 동기화하는 '델타'와 전체 동기화를 수행하는 '초기'입니다(수행 중인 작업을 정확히 알지 않는 한 이 작업을 수행하지 않음). |
|
|
컴퓨터 이름
|
ComputerName | string |
'DirSync' 역할이 있는 서버(즉, 동기화를 수행하는 컴퓨터)입니다. |
|
|
최대 재시도 시도
|
MaxRetryAttempts | integer |
디렉터리 동기화에서 사용 중 또는 시간 제한 오류가 발생하면 일시 중지하고 다시 시도할 수 있습니다. 이 입력은 최대 재시도 횟수를 지정합니다. 재시도를 사용하지 않도록 설정하려면 0으로 설정합니다. 이 값을 너무 높게 설정하면 잠재적인 IA-Connect 작업 시간 제한에 유의하세요. |
|
|
재시도 간격(초)
|
SecondsBetweenRetries | integer |
에이전트가 디렉터리 동기화를 다시 시도하면 재시도 사이에 있을 시간(초)입니다. 1보다 작은 값으로 설정하면 에이전트는 이 입력을 무시하고 1초 값을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
DirSync 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 Active Directory 동기화 작업의 결과입니다. |
Active Directory OU 제거
Active Directory에서 OU(조직 구성 단위)를 제거합니다. OU에 개체(예: 사용자, 그룹 또는 컴퓨터)가 있는 경우 OU를 삭제할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OU ID
|
OUIdentity | True | string |
Active Directory OU의 ID입니다. 고유 이름(예: OU=Servers,OU=London,DC=mydomain,DC=local), GUID 형식 또는 경로(예: London\Servers)로 OU를 지정할 수 있습니다. |
|
보호된 경우에도 삭제
|
DeleteEvenIfProtected | boolean |
삭제로부터 보호되는 경우에도 OU를 삭제하려면 true로 설정합니다. 삭제로부터 보호되지 않는 경우에만 OU를 삭제하고 OU가 보호되는 경우 예외를 발생하도록 false로 설정합니다. |
|
|
OU가 없는 경우 예외 발생
|
RaiseExceptionIfOUDoesNotExist | boolean |
true로 설정하고 OU가 없으면 예외가 발생합니다. false로 설정하고 OU가 없는 경우 작업은 성공을 보고하지만 출력은 삭제되지 않은 OU를 보고합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
삭제된 OU 수
|
NumberOfOUsDeleted | integer |
이 출력에는 0 또는 1이어야 하는 삭제된 AD OU 수가 포함됩니다. |
Active Directory OU 추가
새 OU(Active Directory 조직 구성 단위)를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름
|
Name | True | string |
Active Directory OU의 이름입니다. AD 사용자 및 컴퓨터의 OU 트리 구조와 제목에 있는 OU 속성 '일반' 탭의 맨 위에 표시됩니다. |
|
경로
|
Path | string |
새 OU를 고유 이름 형식(예: OU=Parent OU,OU=London,DC=mydomain,DC=local), GUID 형식 또는 경로(예: London\Parent OU)로 저장할 OU(조직 구성 단위)입니다. 이 값을 비워 두면 트리의 루트에 OU가 만들어집니다. |
|
|
Description
|
Description | string |
선택적 OU 설명입니다. |
|
|
표시 이름
|
DisplayName | string |
선택적 OU 표시 이름입니다. 사용자 계정과 달리 OU 표시 이름은 AD 사용자 및 컴퓨터에 표시되지 않습니다. |
|
|
관리 기준
|
ManagedBy | string |
이 OU를 관리하는 사용자 또는 그룹을 지정합니다. 이 입력은 고유 이름 형식(예: CN=MrBig,OU=London, DC=mydomain,DC=local), GUID 형식, SID 또는 SAMAccountName(예: 'MrBig')으로 지정할 수 있습니다. |
|
|
실수로 삭제되지 않도록 보호됨
|
ProtectedFromAccidentalDeletion | boolean |
실수로 삭제하지 않도록 이 OU를 보호하려면 true(기본값)로 설정합니다. 실수로 삭제되지 않도록 OU를 보호하지 않도록 하려면 false로 설정합니다. |
|
|
주소
|
StreetAddress | string |
OU의 'Street' 속성(AD 사용자 및 컴퓨터의 OU 속성 '일반' 탭). |
|
|
도시
|
City | string |
OU의 'City' 속성(AD 사용자 및 컴퓨터의 OU 속성 '일반' 탭). |
|
|
주
|
State | string |
OU의 'State/province' 속성(AD 사용자 및 컴퓨터의 OU 속성 '일반' 탭에서). |
|
|
우편번호
|
PostalCode | string |
OU의 'ZIP/우편 번호' 속성(AD 사용자 및 컴퓨터의 OU 속성 '일반' 탭). |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
만든 OU 고유 이름
|
CreatedOUDistinguishedName | string |
만든 OU의 Active Directory DN(고유 이름)입니다. |
Active Directory OU가 있는지 확인
OU(Active Directory 조직 구성 단위)가 있는지 보고합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OU ID
|
OUIdentity | True | string |
고유 이름 형식(예: OU=Target OU,OU=London,DC=mydomain,DC=local), GUID 형식 또는 경로(예: London\Target OU)의 OU(대상 조직 구성 단위)에 대한 경로입니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
JSON으로 OU 속성
|
PowerShellJSONOutput | string |
OU(조직 구성 단위)의 세부 정보입니다. |
|
OU가 있음
|
OUExists | boolean |
OU(조직 구성 단위)가 있는 경우 true로 설정하고, 그렇지 않으면 false로 설정합니다. |
Active Directory PowerShell 스크립트 실행
IA-Connect 에이전트가 실행되는 세션의 Active Directory Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 지정 Active Directory PowerShell 코드를 실행하는 데 권장되는 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
PowerShell 스크립트 내용
|
PowerShellScriptContents | string |
Active Directory Runspace에서 실행할 PowerShell 스크립트의 내용입니다. IA-Connect PowerShell 자동화 엔진에 직접 전달하여 이 스크립트 as-is 실행합니다. 실제로 디스크에 PowerShell 스크립트가 만들어지지 않습니다. 또는 return 및 'scriptpath'를 입력하여 디스크에서 기존 PowerShell 스크립트를 실행할 수 있습니다. 예: return & 'c:\scripts\ADTestScript.ps1'. |
|
|
결과가 없나요? 오류
|
IsNoResultAnError | boolean |
PowerShell 명령에서 반환되는 데이터가 없는 경우 오류가 발생하나요? |
|
|
복합 형식 반환
|
ReturnComplexTypes | boolean |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. '컬렉션으로 반환할 속성', 'serialize할 속성 이름' 및 '직렬화할 속성 형식'을 입력하면 반환해야 하는 '복합' 속성과 데이터 형식을 지정하는 데 사용되는 메서드를 지정할 수 있습니다(속성별로 가장 적합한 속성 선택). 이 입력을 사용하면 나머지 속성(즉, '복합'이고 명시적으로 이름이 지정되지 않은 속성)을 사용하여 수행해야 하는 작업을 지정할 수 있습니다. true로 설정하면 IA-Connect ToString()을 사용하여 데이터의 문자열 표현을 반환하려고 합니다. false(기본값)로 설정하면 IA-Connect 속성을 반환하지 않습니다. |
|
|
부울을 부울로 반환
|
ReturnBooleanAsBoolean | boolean |
부울 속성을 부울로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
숫자를 10진수로 반환
|
ReturnNumericAsDecimal | boolean |
숫자 속성을 숫자로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
날짜로 반환 날짜
|
ReturnDateAsDate | boolean |
Date 속성을 날짜로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
컬렉션으로 반환할 속성
|
PropertiesToReturnAsCollectionJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 컬렉션으로 반환해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있습니다. 속성, 해당 형식 및 값에 따라 대체 입력 '직렬화할 속성 이름' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 JSON 또는 CSV 형식으로 입력할 수 있습니다. 예를 들어 EmailAddresses 및 MemberOf 배열 속성을 반환하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
스크립트를 스레드로 실행
|
RunScriptAsThread | boolean |
false(기본값)로 설정하면 IA-Connect 에이전트는 PowerShell 스크립트를 즉시 실행하고 스크립트가 완료되면 디렉터에게 결과를 반환합니다. 오래되거나 복잡한 PowerShell 스크립트를 실행하는 경우 이 작업은 시간이 초과할 수 있습니다. true로 설정하면 IA-Connect 에이전트가 PowerShell 스크립트를 에이전트 스레드로 실행하고 IA-Connect 디렉터(또는 Orchestrator, PowerShell 모듈, Blue Prism)가 이 에이전트 스레드의 상태를 모니터링하여 완료될 때까지 대기할 수 있습니다. 이렇게 하면 긴 또는 복잡한 PowerShell 스크립트를 시간 제한 없이 실행할 수 있습니다. IA-Connect 에이전트 9.3 이하에서는 PowerShell 스크립트를 에이전트 스레드로 실행할 수 없습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 PowerShell 스크립트를 에이전트 스레드로 실행하고 '스레드를 기다리는 초'를 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. PowerShell 스크립트를 실행하기만 하면 0(기본값)으로 설정됩니다(따라서 에이전트 스레드로 실행되는 이전 PowerShell 스크립트의 결과를 검색하지 않음). |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 스크립트 실행'이 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 현재 PowerShell 스크립트를 실행하는 에이전트 스레드가 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 계속해서 PowerShell 스크립트를 실행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 에이전트 스레드가 완료되기를 기다리는 '에이전트 스레드가 성공적으로 완료되기를 기다립니다' 작업을 사용하여 나중에 스크립트 결과를 검색한 다음 에이전트 스레드 ID로 설정된 입력 '스레드 ID에 대한 출력 데이터 검색'을 사용하여 이 'PowerShell 스크립트 실행' 작업을 다시 실행할 수 있습니다. |
|
|
스크립트에 저장된 암호가 포함되어 있습니다.
|
ScriptContainsStoredPassword | boolean |
스크립트에 {IAConnectPassword:StoredPasswordIdentifier} 형식의 IA-Connect 저장된 암호 식별자 또는 {OrchestratorCredential:FriendlyName} 형식의 IA-Connect Orchestrator 제네릭 자격 증명이 포함된 경우 true로 설정합니다. { } 구는 지정된 암호로 대체되고 이스케이프되어 작은따옴표로 배치됩니다(스크립트에 이미 따옴표가 없는 경우). |
|
|
자세한 정보 출력 기록
|
LogVerboseOutput | boolean |
powerShell 자세한 정보 출력을 IA-Connect 로그에 기록하려면 true로 설정합니다. 디버깅에 유용할 수 있습니다. 스크립트에서 자세한 내용을 기록하려면 '내 메시지' -자세한 정보 표시를 Write-Verbose PowerShell을 사용합니다. |
|
|
serialize할 속성 이름
|
PropertyNamesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 serialize해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 예를 들어 EmailAddresses 및 MemberOf 속성을 직렬화하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
직렬화할 속성 형식
|
PropertyTypesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 직렬화해야 하는 '복합' 속성(형식별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 이름'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 단일 'PropertyType' 필드가 있는 컬렉션입니다. 예: Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]형식의 속성을 직렬화하려면 [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}]를 입력합니다(JSON 테이블 형식), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"](JSON 배열 형식) 또는 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[](CSV 형식). |
|
|
이름
|
Name | string |
입력 PowerShell 매개 변수의 이름입니다. PowerShell 변수 명명 형식을 충족해야 합니다(즉, 공백 또는 특수 기호를 사용하지 않는 것이 좋습니다). PowerShell 변수 이름은 대/소문자를 구분하지 않습니다. 예를 들어 MyVariable은 변수 $MyVariable 생성됩니다. |
|
|
문자열 값
|
StringValue | string |
입력 PowerShell 매개 변수에 할당할 문자열 값입니다. 또는 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
정수 값
|
IntValue | integer |
입력 PowerShell 매개 변수에 할당할 정수(정수) 값입니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
부울 값
|
BooleanValue | boolean |
입력 PowerShell 매개 변수에 할당할 부울(true 또는 false) 값입니다. 또는 문자열 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
십진수 값
|
DecimalValue | double |
입력 PowerShell 매개 변수에 할당할 10진수 값입니다. 또는 문자열, 부울 또는 정수 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
개체 값
|
ObjectValue | object |
입력 PowerShell 매개 변수에 할당할 개체 값입니다. PowerShell 스크립트에서 JSON 직렬화된 문자열 변수가 되므로 ConvertFrom-Json을 사용하여 개체로 역직렬화합니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
스레드 ID
|
ThreadId | integer |
PowerShell 스크립트를 에이전트 스레드로 실행하는 경우 이 출력에는 PowerShell 스크립트 실행을 모니터링하고 스크립트가 완료될 때 PowerShell 스크립트 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
Active Directory 계정 잠금 해제
Active Directory 계정의 잠금을 해제합니다. 계정이 잠겨 있지 않으면 이 명령은 아무 작업도 수행하지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryUnlockADAccountByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 그룹 가져오기
지정된 Active Directory 그룹 또는 그룹의 속성을 반환합니다. ID(단일 그룹 찾기) 또는 필터(하나 이상의 그룹 찾기)를 사용하여 검색할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아이덴티티
|
Identity | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 그룹을 필터링할 속성의 이름을 제공합니다. 그룹 검색의 일반적인 속성 이름은 이름, 설명, samaccountname입니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. LDAP 필터를 입력하려면 'LDAP: LDAP 필터 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 그룹을 필터링할 '필터 속성 이름' 값입니다. |
|
|
OU 기본 검색
|
SearchOUBase | string |
검색할 최상위 OU(조직 구성 단위)입니다. ID가 아닌 필터를 사용하여 검색할 때만 지원됩니다. 지정하지 않으면 전체 도메인이 검색됩니다. OU는 고유 이름 형식(예: OU=London,OU=MyGroups, DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyGroups\London)로 지정할 수 있습니다. |
|
|
OU 기본 하위 트리 검색
|
SearchOUBaseSubtree | boolean |
true(기본값)로 설정하고 검색 OU 기반이 제공되면 검색 OU 기반과 모든 하위 OU가 검색됩니다. false로 설정하고 검색 OU 베이스가 제공되면 검색 OU 베이스만 검색됩니다. 검색 OU 기반이 제공되지 않거나 ID로 검색하는 경우 이 입력은 사용되지 않습니다. |
|
|
그룹이 없는 경우 예외 발생
|
RaiseExceptionIfGroupDoesNotExist | boolean |
true로 설정하고 그룹이 없으면 예외가 발생합니다. false로 설정하고 그룹이 없는 경우 작업은 성공을 보고하지만 출력은 그룹을 찾을 수 없음을 보고합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
검색 ID와 일치하는 그룹(및 요청된 속성) 목록입니다. |
|
찾은 그룹 수
|
CountOfGroupsFound | integer |
검색 ID와 일치하는 찾은 그룹 수입니다. ID 검색의 경우 예상 값은 0 또는 1이거나 필터 검색의 값입니다. |
Active Directory 그룹 구성원 가져오기
Active Directory 그룹의 멤버 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | True | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
재귀
|
Recursive | boolean |
false(기본값)로 설정하면 그룹의 직접 멤버만 반환됩니다. true로 설정하면 멤버의 직접 멤버와 멤버가 반환되고, 기본적으로 모든 수준에서 모든 AD 멤버가 반환됩니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그룹 구성원 JSON
|
GroupMembersJSON | string |
JSON 형식의 AD 그룹 멤버 목록입니다. |
|
찾은 그룹 구성원 수
|
CountOfGroupMembersFound | integer |
AD 그룹 멤버 수입니다. |
Active Directory 그룹 구성원 제거
Active Directory 그룹에서 Active Directory 멤버(사용자, 그룹 또는 컴퓨터)를 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
|
그룹 이름
|
GroupName | string |
ID로 검색하는 대신 Active Directory 그룹의 2K 이전 이름(SAMAccountName)을 제공합니다. '그룹 ID' 입력도 2K 이전 이름을 허용하므로 이 입력은 이제 중복되지만 이전 버전과의 호환성을 위해 유지 관리됩니다. |
|
|
그룹 구성원
|
UserIdentity | True | string |
제거할 그룹 구성원입니다. 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryRemoveADGroupMemberByGroupIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 그룹 구성원 추가
기존 Active Directory 그룹에 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 추가합니다. 그룹 및 그룹 멤버가 서로 다른 도메인에 있는 경우 그룹 및 멤버 모두에 대해 DN(고유 이름)을 지정해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
|
그룹 이름
|
GroupName | string |
ID로 검색하는 대신 Active Directory 그룹의 2K 이전 이름(SAMAccountName)을 제공합니다. '그룹 ID' 입력도 2K 이전 이름을 허용하므로 이 입력은 이제 중복되지만 이전 버전과의 호환성을 위해 유지 관리됩니다. |
|
|
그룹 구성원
|
UserIdentity | True | string |
추가할 그룹 멤버(일반적으로 사용자, 그룹 또는 컴퓨터)입니다. 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryAddADGroupMemberByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 그룹 제거
Active Directory에서 그룹을 제거합니다. 그룹에 개체(예: 사용자, 그룹 또는 컴퓨터)가 있는 경우 해당 개체는 그룹 삭제의 일부로 제거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | True | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
보호된 경우에도 삭제
|
DeleteEvenIfProtected | boolean |
그룹을 삭제하지 않도록 보호되더라도 그룹을 삭제하려면 true로 설정합니다. 삭제로부터 보호되지 않는 경우에만 그룹을 삭제하고 그룹이 보호되는 경우 예외를 발생하려면 false로 설정합니다. |
|
|
그룹이 없는 경우 예외 발생
|
RaiseExceptionIfGroupDoesNotExist | boolean |
true로 설정하고 그룹이 없으면 예외가 발생합니다. false로 설정하고 그룹이 없는 경우 작업은 성공을 보고하지만 출력은 삭제된 그룹이 없음을 보고합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
삭제된 그룹 수
|
NumberOfGroupsDeleted | integer |
이 출력에는 삭제된 AD 그룹 수가 포함되며 0 또는 1이어야 합니다. |
Active Directory 그룹 추가
새 Active Directory 그룹을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름
|
Name | True | string |
Active Directory 그룹의 이름입니다. 이는 AD 사용자 및 컴퓨터의 '이름' 열과 제목에 있는 그룹 '일반' 탭의 맨 위에 나타납니다. |
|
SAM 계정 이름
|
SamAccountName | string |
Active Directory의 그룹 이름(Windows 2000 이전)입니다. 'name' 형식입니다(예: 'TestGroup1'). |
|
|
경로
|
Path | string |
그룹을 고유 이름 형식(예: OU=Target OU,OU=London,DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyGroups\London)로 저장할 OU(조직 구성 단위)입니다. 비워 두면 그룹이 '사용자' OU에 만들어집니다. |
|
|
Description
|
Description | string |
선택적 그룹 설명입니다. |
|
|
비고
|
Notes | string |
선택적 그룹 노트입니다. |
|
|
표시 이름
|
DisplayName | string |
선택적 그룹 표시 이름입니다. 사용자 계정과 달리 그룹 표시 이름은 AD 사용자 및 컴퓨터에 표시되지 않습니다. |
|
|
그룹 범주
|
GroupCategory | True | string |
만들 그룹의 형식입니다. 보안 그룹은 일반적으로 IT 리소스에 대한 사용자 및 컴퓨터 액세스를 관리하는 데 사용됩니다. 메일 그룹은 일반적으로 그룹 전자 메일을 만드는 데 사용되므로 사용자 그룹을 전자 메일로 보낼 수 있습니다. |
|
그룹 범위
|
GroupScope | True | string |
만들 그룹의 범위입니다. 해당 그룹의 범위에 따라 그룹을 참조할 수 있는 위치와 그룹에 배치할 수 있는 항목을 설명하는 복잡한 규칙 집합이 있습니다. 나중에 다른 그룹 범위로 변환할 수 없으므로 만들 때 올바른 범위를 선택해야 합니다. |
|
홈 페이지
|
HomePage | string |
선택적 그룹 홈페이지입니다. |
|
|
관리 기준
|
ManagedBy | string |
이 그룹을 관리하는 사용자 또는 그룹을 지정합니다. 이 입력은 고유 이름 형식(예: CN=MrBig,OU=London, DC=mydomain,DC=local), GUID 형식, SID 또는 SAMAccountName(예: 'MrBig')으로 지정할 수 있습니다. |
|
|
실수로 삭제되지 않도록 보호됨
|
ProtectedFromAccidentalDeletion | boolean |
실수로 삭제하지 않도록 이 그룹을 보호하려면 true로 설정합니다. 실수로 인한 삭제로부터 보호되지 않는 기본값으로 그룹을 유지하려면 false로 설정합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
만든 그룹 고유 이름
|
CreatedGroupDistinguishedName | string |
만든 그룹의 Active Directory DN(고유 이름)입니다. |
|
만든 그룹 SAM 계정 이름
|
CreatedGroupSAMAccountName | string |
만든 그룹의 Active Directory SAM 계정 이름입니다. |
Active Directory 그룹이 존재하나요?
지정된 Active Directory 그룹이 있는지 여부를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | True | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹이 있음
|
ADGroupExists | boolean |
이 출력은 AD 그룹이 있으면 true를 반환하고, AD 그룹이 없으면 false를 반환합니다. |
|
AD 그룹 DN
|
ADGroupDN | string |
AD 그룹이 있는 경우 이 출력에는 DN(고유 이름) 그룹이 포함됩니다. |
Active Directory 도메인 정보 가져오기
Active Directory 도메인에 대한 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
AD 서버
|
ADServer | string |
도메인 요청을 보낼 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 그러면 도메인 컨트롤러가 지정된 도메인에 대해 요청된 정보를 가져옵니다. |
|
|
미리 정의된 도메인 ID
|
PredefinedIdentity | string |
사용자: 현재 로그인한 사용자가 속한 도메인에 대한 정보가 검색됩니다. 컴퓨터: 컴퓨터(IA-Connect 세션이 실행 중임)가 속한 도메인에 대한 정보가 검색됩니다. 수동: '도메인 ID' 필드에 Active Directory 도메인을 입력합니다. 이 필드가 비어 있고 '도메인 ID' 필드에 값이 있으면 해당 값이 사용됩니다. |
|
|
도메인 ID
|
Identity | string |
이 필드는 '미리 정의된 도메인 ID'가 '수동'(또는 비어 있음)으로 설정된 경우에만 사용됩니다. 도메인 정보를 검색할 Active Directory 도메인의 ID입니다. 고유 이름(예: DC=mydomain,DC=local), GUID, SID, DNS 도메인 이름(예: mydomain.local) 또는 NetBIOS 이름(예: MYDOMAIN)으로 Active Directory 도메인을 지정할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
고유 이름
|
DistinguishedName | string |
도메인의 DN(고유 이름)입니다. |
|
DNS 루트 이름
|
DNSRoot | string |
도메인의 최상위 DNS 루트 이름입니다. |
|
도메인 모드
|
DomainMode | string |
도메인의 모드 또는 수준(예: Windows2003Domain 또는 Windows2016Domain)입니다. |
|
도메인 SID
|
DomainSID | string |
도메인의 SID(보안 식별자)입니다. |
|
숲
|
Forest | string |
Active Directory 포리스트(최상위 논리 컨테이너)의 이름입니다. |
|
인프라 마스터
|
InfrastructureMaster | string |
인프라 마스터 역할이 있는 DC(도메인 컨트롤러)의 이름입니다. |
|
도메인 NetBIOS 이름
|
NetBIOSName | string |
도메인의 NetBIOS 이름(예: MYDOMAIN)입니다. |
|
도메인 GUID
|
ObjectGUID | string |
도메인의 GUID입니다. |
|
PDC 에뮬레이터
|
PDCEmulator | string |
PDC 에뮬레이터 역할이 있는 DC(도메인 컨트롤러)의 이름입니다. |
|
RID 마스터
|
RIDMaster | string |
RID 마스터 역할이 있는 DC(도메인 컨트롤러)의 이름입니다. |
Active Directory 사용자 가져오기
지정된 Active Directory 사용자의 속성을 반환합니다. ID(단일 사용자 찾기) 또는 필터(하나 이상의 사용자 찾기)를 사용하여 검색할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아이덴티티
|
Identity | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 사용자를 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 다음과 같습니다. city, company, country, department, description, displayname, division, emailaddress, enabled, givenname, homedirectory, homedrive, homephone, initials, manager, office, organization, postalcode, profilepath, samaccountname, scriptpath, state, streetaddress, surname, title, userprincipalname. 입력 '필터 속성 비교'를 Raw 또는 LDAP로 설정하는 경우 이 입력을 비워 둘 수 있습니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. LDAP 필터를 입력하려면 'LDAP: LDAP 필터 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID를 기준으로 검색하는 대신 사용자를 필터링할 '필터 속성 이름' 값입니다. |
|
|
OU 기본 검색
|
SearchOUBase | string |
검색할 최상위 OU(조직 구성 단위)입니다. ID가 아닌 필터를 사용하여 검색할 때만 지원됩니다. 지정하지 않으면 전체 도메인이 검색됩니다. 검색 기본 OU는 고유 이름 형식(예: OU=London,OU=MyUsers,DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyUsers\London)로 지정할 수 있습니다. |
|
|
OU 기본 하위 트리 검색
|
SearchOUBaseSubtree | boolean |
true(기본값)로 설정하고 검색 OU 기반이 제공되면 검색 OU 기반과 모든 하위 OU가 검색됩니다. false로 설정하고 검색 OU 베이스가 제공되면 검색 OU 베이스만 검색됩니다. 검색 OU 기반이 제공되지 않거나 ID로 검색하는 경우 이 입력은 사용되지 않습니다. |
|
|
검색할 속성
|
Properties | string |
검색할 추가 사용자 속성의 쉼표로 구분된 목록입니다. 일반적인 속성은 다음과 같습니다. 도시, 회사, 국가, 부서, 설명, 표시 이름, 부서, emailaddress, enabled, givenname, homedirectory, homedrive, homephone, initials, manager, office, organization, postalcode, profilepath, samaccountname, scriptpath, state, streetaddress, surname, title, userprincipalname. 이 필드를 비워 두면 기본 속성 집합이 반환됩니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
컬렉션으로 반환할 속성
|
PropertiesToReturnAsCollectionJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 컬렉션으로 반환해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있습니다. 속성, 해당 형식 및 값에 따라 대체 입력 '직렬화할 속성 이름' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 JSON 또는 CSV 형식으로 입력할 수 있습니다. 예를 들어 EmailAddresses 및 MemberOf 배열 속성을 반환하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
serialize할 속성 이름
|
PropertyNamesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 serialize해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 예를 들어 EmailAddresses 및 MemberOf 속성을 직렬화하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
직렬화할 속성 형식
|
PropertyTypesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 직렬화해야 하는 '복합' 속성(형식별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 이름'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 단일 'PropertyType' 필드가 있는 컬렉션입니다. 예: Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]형식의 속성을 직렬화하려면 [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}]를 입력합니다(JSON 테이블 형식), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"](JSON 배열 형식) 또는 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[](CSV 형식). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
검색 ID와 일치하는 사용자(및 요청된 속성)의 목록(JSON 형식)입니다. |
|
찾은 사용자 수
|
CountOfUsersFound | integer |
검색 ID와 일치하는 사용자 수를 찾습니다. ID로 검색하는 경우 일반적으로 0 또는 1이거나 필터 속성으로 검색하는 경우 0 이상입니다. |
Active Directory 사용자 계정 만료 날짜 설정
Active Directory 사용자 계정의 계정 만료 날짜를 설정합니다. 이 날짜는 계정을 사용할 수 있는 마지막 하루 종일이므로 기술적으로는 다음 날 시작 시 계정이 만료됩니다. IA-Connect 에이전트는 이를 인식하고 Active Directory에 날짜를 저장할 때 제공된 입력 날짜에 1일을 자동으로 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
연도
|
Year | True | integer |
계정이 만료되어야 하는 연도입니다. 예: 2023. |
|
Month
|
Month | True | integer |
계정이 만료되어야 하는 월의 수입니다. 1월 = 12월 1일 = 12. 예: 6. |
|
Day
|
Day | True | integer |
계정이 만료되는 날짜의 수입니다. 월의 첫째 날 = 1. 예: 19. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectorySetADUserAccountExpirationEndOfDateResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 계정 만료 지우기
Active Directory 계정의 만료 날짜를 지웁니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryClearADUserAccountExpirationResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 계정 사용
Active Directory 사용자 계정을 사용하도록 설정합니다. 계정을 사용하지 않도록 설정하지 않으면 이 명령은 아무 작업도 수행하지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryEnableADUserByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 계정 사용 안 함
Active Directory 사용자 계정을 사용하지 않도록 설정합니다. 사용자 계정을 사용하지 않도록 설정하면 사용자가 로그온할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryDisableADUserByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 그룹 멤버 자격 가져오기
지정된 사용자가 멤버로 속해 있는 Active Directory 그룹 목록을 반환하며, 기술적으로 멤버 자격이 아니므로 기본 그룹(일반적으로 '도메인 사용자')을 뺀 값입니다. 이 작업은 사용자 계정에서만 작동하므로 이 작업을 사용하여 그룹 또는 컴퓨터의 그룹 멤버 자격을 쿼리할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
그룹 멤버 자격을 쿼리할 사용자입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그룹 멤버 자격 JSON
|
GroupMembershipJSON | string |
사용자가 멤버인 AD 그룹 목록은 JSON 형식입니다. |
|
찾은 그룹 수
|
CountOfGroupsFound | integer |
사용자가 멤버인 AD 그룹의 수에서 계산되지 않는 기본 그룹(일반적으로 '도메인 사용자')을 뺀 값입니다. |
Active Directory 사용자 그룹 멤버 자격 복제
대상 Active Directory 사용자를 첫 번째 사용자가 멤버로 속해 있는 동일한 Active Directory 그룹에 추가하고, 기술적으로 멤버 자격이 아니므로 기본 그룹(일반적으로 '도메인 사용자')을 뺀 값입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
원본 사용자 ID
|
SourceUserIdentity | True | string |
원본 Active Directory 사용자의 ID(그룹을 복사할 사용자)입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
대상 사용자 ID
|
DestinationUserIdentity | True | string |
대상 Active Directory 사용자(그룹을 추가할 사용자)의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹이 성공적으로 추가됨
|
ADGroupsAddedSuccessfully | integer |
대상 사용자가 성공적으로 추가된 AD 그룹의 수입니다. |
|
AD 그룹을 추가하지 못했습니다.
|
ADGroupsFailedToAdd | integer |
대상 사용자가 추가하지 못한 AD 그룹의 수입니다. |
|
AD 그룹 추가 오류 메시지
|
AddADGroupsMasterErrorMessage | string |
대상 사용자가 일부 AD 그룹에 추가하지 못한 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
Active Directory 사용자 문자열 속성 수정
Active Directory 사용자의 개별 문자열 속성을 수정합니다. 이렇게 하면 사용자 지정 속성을 포함하여 매우 구체적인 사용자 설정을 수정할 수 있습니다. 개별 사용자 속성을 비워 둘 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
재산
|
Property | string | ||
|
가치
|
Value | string | ||
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
값 바꾸기
|
ReplaceValue | boolean |
값을 바꾸려면 true로 설정합니다. 값을 추가하려면 false로 설정합니다. 값이 이미 있는 경우(사용자 지정 속성에만 영향을 주는 경우) 추가는 작동하지 않는 반면 바꾸기를 사용하여 새 값을 만들거나 기존 값을 바꿀 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryModifyADUserStringPropertyByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 부울 속성 수정
Active Directory 사용자의 개별 부울(true/false) 속성을 수정합니다. 이렇게 하면 사용자 지정 속성을 포함하여 매우 구체적인 사용자 설정을 수정할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
속성 이름
|
PropertyName | True | string |
수정할 개별 사용자 속성의 이름입니다. 일반적인 부울 속성은 enabled, mTSAllowLogon, msExchHideFromAddressLists입니다. |
|
속성 값
|
PropertyValue | boolean |
지정된 속성에 할당할 true/false 값입니다. 값을 null로 설정해야 하는 경우 빈 속성 값과 함께 'Active Directory 사용자 문자열 속성 수정' 작업을 대신 사용하고 '값 바꾸기'를 '예'로 설정합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryModifyADUserBooleanPropertyByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 속성 복제
원본 Active Directory 사용자의 지정된 속성/특성을 대상 Active Directory 사용자로 구성합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
원본 사용자 ID
|
SourceUserIdentity | True | string |
원본 Active Directory 사용자의 ID(특성을 복사할 사용자)입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
대상 사용자 ID
|
DestinationUserIdentity | True | string |
대상 Active Directory 사용자의 ID(특성을 복사할 사용자)입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
복제할 속성
|
PropertiesToClone | True | string |
원본 사용자에서 대상 사용자로 복사할 사용자 속성의 쉼표로 구분된 목록입니다. 복제할 일반적인 속성에는 city, company, country, department, description, division, enabled, homedirectory, homedrive, homephone, manager, office, organization, postalcode, profilepath, scriptpath, state, streetaddress가 포함됩니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryCloneADUserPropertiesResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 암호 다시 설정
새 암호로 Active Directory 사용자의 암호를 다시 설정하고 필요에 따라 암호 속성을 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
새 암호
|
NewPassword | True | password |
새 암호입니다. 이를 지정하고 Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
사용자 암호 속성 설정
|
SetUserPasswordProperties | boolean |
암호를 변경하는 것 외에도 지정된 사용자 암호 속성을 설정하려면 예(기본값)로 설정합니다. 사용자 암호 속성은 '로그온 시 암호 변경', '사용자가 암호를 변경할 수 없음' 및 '암호가 만료되지 않음'입니다. 이 작업에 대한 다른 입력을 무시하고 사용자의 암호만 변경하려면 아니요로 설정합니다. |
|
|
다음 로그온할 때 반드시 암호 변경
|
ChangePasswordAtLogon | boolean |
사용자가 로그인할 때 암호를 변경하도록 강제하려면 예(기본값)로 설정합니다(즉, 여기에 설정된 새 암호는 사용자가 로그인하도록 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호이면 아니요로 설정합니다. 이 암호 옵션을 변경하지 않고 비워 두려면 비어 있음/비워 둡니다(IA-Connect 9.4의 새로운 기능). '사용자가 암호를 변경할 수 없음' 또는 '암호가 만료되지 않음'을 Yes로 설정하는 것과 동시에 이 옵션을 Yes로 설정할 수 없습니다. |
|
|
사용자가 암호를 변경할 수 없음
|
CannotChangePassword | boolean |
사용자가 암호를 변경할 수 있기를 중지하려면 예로 설정합니다. 사용자가 암호를 변경할 수 있는 경우 아니요(기본값)로 설정합니다. 이 암호 옵션을 변경하지 않고 비워 두려면 비어 있음/비워 둡니다(IA-Connect 9.4의 새로운 기능). '사용자가 다음 로그인 시 암호를 변경해야 함'을 Yes로 설정하는 것과 동시에 이 옵션을 Yes로 설정할 수 없습니다. |
|
|
비밀번호가 만료되지 않음
|
PasswordNeverExpires | boolean |
암호가 만료되지 않는 경우 예로 설정합니다(즉, 사용자에게 암호를 변경하라는 메시지가 표시되지 않음). Active Directory 도메인 정책에 설정된 대로 암호가 만료 될 수 있으면 아니요(기본값)로 설정합니다. 이 암호 옵션을 변경하지 않고 비워 두려면 비어 있음/비워 둡니다(IA-Connect 9.4의 새로운 기능). '사용자가 다음 로그인 시 암호를 변경해야 함'을 Yes로 설정하는 것과 동시에 이 옵션을 Yes로 설정할 수 없습니다. |
|
|
암호 다시 설정(두 번)
|
ResetPasswordTwice | boolean |
암호를 두 번 다시 설정하려면 Yes로 설정합니다. 첫 번째 재설정은 요청된 새 암호의 임의화(대문자, 소문자, 숫자 및 동일한 기호의 수와 같지만 임의 순서로)입니다. 이렇게 하면 이 사용자를 Azure Active Directory에 동기화하는 경우 해시 전달 취약성의 위험이 완화됩니다. 먼저 임의 암호를 설정하지 않고 요청된 암호를 설정하려면 아니요(기본값)로 설정합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryResetADUserPasswordByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 제거
Active Directory에서 사용자를 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
실수로 인한 삭제로부터 보호 제거
|
RemoveProtectionFromAccidentalDeletion | boolean |
사용자를 제거하기 전에 실수로 인한 삭제로부터 보호를 제거하려면 true로 설정합니다. |
|
|
사용자에게 하위 개체가 있더라도 제거
|
DeleteEvenIfUserHasSubObjects | boolean |
사용자 계정에 하위 개체가 있는 경우(즉, 사용자가 리프 개체가 아닌 경우) 사용자를 제거하는 일반 명령이 실패합니다. 하위 개체가 검색된 경우 대체 삭제 방법으로 대체하려는 경우 이 입력을 true로 설정합니다. |
|
|
강제 삭제 재귀
|
ForceDeleteRecursive | boolean |
사용자 계정에 하위 개체가 있는 경우(즉, 사용자가 리프 개체가 아닌 경우) 사용자를 제거하는 일반 명령이 실패합니다. 재귀 하위 개체 삭제를 수행하려면 먼저 사용자를 정상적으로 제거하지 않고 이 입력을 true로 설정합니다. 이는 대체 검색이 작동하지 않는 경우에 유용할 수 있습니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryRemoveADUserByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자 추가
새 Active Directory 사용자 계정을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름
|
Name | True | string |
Active Directory 사용자의 이름입니다. 이는 AD 사용자 및 컴퓨터의 '이름' 열과 제목에 있는 사용자 '일반' 탭의 맨 위에 나타납니다. 사용자 로그온 이름이 아닙니다. |
|
사용자 주 이름
|
UserPrincipalName | string |
Active Directory의 사용자 로그온 이름입니다. 일반적으로 'name@domainFQDN' 형식이어야 합니다(예: 'TestUser1@domain.local'). 사용자는 name@domainFQDN 형식을 사용하여 로그온할 수 있습니다. |
|
|
SAM 계정 이름
|
SamAccountName | string |
Active Directory의 사용자 로그온 이름(Windows 2000 이전)입니다. 'name' 형식입니다(예: 'TestUser1'). 사용자는 도메인\name 형식을 사용하여 로그온할 수 있습니다. |
|
|
이름 (이름의 첫 부분)
|
GivenName | string |
선택적 사용자 이름입니다. |
|
|
성(姓)
|
SurName | string |
선택적 사용자 성입니다. |
|
|
경로
|
Path | string |
사용자를 고유 이름 형식(예: OU=Target OU,OU=London,DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyUsers\London)로 저장할 OU(조직 구성 단위)입니다. 이 값을 비워 두면 사용자가 '사용자' OU에 만들어집니다. |
|
|
Description
|
Description | string |
선택적 사용자 설명입니다. |
|
|
표시 이름
|
DisplayName | string |
선택적 사용자 표시 이름입니다. |
|
|
계정 암호
|
AccountPassword | password |
사용자 암호입니다. 이를 지정하고 Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
활성화됨
|
Enabled | boolean |
계정을 만든 직후 사용하도록 설정하려면 true로 설정합니다. 계정을 사용할 수 없도록 설정하려면 false로 설정합니다. 이 옵션은 기본적으로 true로 설정됩니다. |
|
|
다음 로그온할 때 반드시 암호 변경
|
ChangePasswordAtLogon | boolean |
사용자가 로그인할 때 암호를 변경하도록 강제하려면 true로 설정합니다(즉, 여기에 설정된 새 암호는 사용자가 로그인하도록 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호인 경우 false로 설정합니다. '사용자가 암호를 변경할 수 없음' 또는 '암호가 만료되지 않음'을 true로 설정하는 것과 동시에 이 옵션을 true로 설정할 수 없습니다. |
|
|
사용자가 암호를 변경할 수 없음
|
CannotChangePassword | boolean |
사용자가 암호를 변경할 수 있기를 중지하려면 true로 설정합니다. 사용자가 암호를 변경할 수 있으면 false로 설정합니다. '사용자가 다음 로그인 시 암호를 변경해야 함'을 true로 설정하는 것과 동시에 이 옵션을 true로 설정할 수 없습니다. |
|
|
비밀번호가 만료되지 않음
|
PasswordNeverExpires | boolean |
암호가 만료되지 않는 경우 true로 설정합니다(즉, 사용자에게 암호를 변경하라는 메시지가 표시되지 않음). Active Directory 도메인 정책에 설정된 대로 암호가 만료 될 수 있으면 false로 설정합니다. '사용자가 다음 로그인 시 암호를 변경해야 함'을 true로 설정하는 것과 동시에 이 옵션을 true로 설정할 수 없습니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
만든 사용자 고유 이름
|
CreatedUserDistinguishedName | string |
만든 사용자 계정의 Active Directory DN(고유 이름)입니다. |
|
만든 사용자 SAM 계정 이름
|
CreatedUserSAMAccountName | string |
만든 사용자 계정의 Active Directory SAM 계정 이름입니다. |
|
만든 사용자 계정 이름
|
CreatedUserPrincipalName | string |
만든 사용자 계정의 Active Directory UPN(사용자 계정 이름)입니다. |
Active Directory 사용자 홈 폴더 수정
Active Directory 사용자의 홈 폴더/디렉터리/드라이브를 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
홈 드라이브
|
HomeDrive | string |
홈 디렉터리/폴더가 네트워크 공유에 있는 경우 해당 위치에 매핑될 드라이브 문자를 지정합니다. 드라이브 문자는 일반적으로 'F'와 'Z' 사이의 단일 문자입니다. 홈 디렉터리/폴더가 로컬인 경우 이 값을 비워 둡니다. 홈 디렉터리/폴더를 비워 두는 경우 이 값도 비워 둡니다. |
|
|
홈 디렉터리
|
HomeDirectory | string |
홈 폴더/디렉터리의 경로를 지정합니다. 홈 드라이브 문자도 지정하는 경우 홈 드라이브가 이 폴더/디렉터리에 매핑됩니다. 홈 디렉터리/폴더를 공백으로 설정하는 경우 이 값을 공백으로 설정합니다. |
|
|
폴더 만들기
|
CreateFolder | boolean |
홈 폴더/디렉터리가 없는 경우 만들려면 true로 설정합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectorySetADUserHomeFolderByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 사용자를 OU로 이동
Active Directory 사용자를 기존 OU(Active Directory 조직 구성 단위)로 이동합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
대상 경로
|
TargetPath | True | string |
고유 이름 형식(예: OU=Target OU,OU=London, DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyUsers\London)의 OU(대상 조직 구성 단위)에 대한 경로입니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryMoveADUserToOUByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 서버 설정
모든 추가 Active Directory 작업에 사용할 특정 Active Directory 서버를 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
미리 정의된 AD 서버 선택
|
PredefinedADServerChoice | string |
사용자 PDC: 현재 로그인한 사용자가 속한 도메인에 대한 PDC 에뮬레이터가 사용됩니다. 컴퓨터 PDC: 컴퓨터(IA-Connect 세션이 실행 중임)가 속한 도메인에 대한 PDC 에뮬레이터가 사용됩니다. 수동: 'AD 서버' 필드에 DC(Active Directory 도메인 컨트롤러)를 입력합니다. 이 필드가 비어 있고 'AD 서버' 필드에 값이 있는 경우 해당 값이 사용됩니다. |
|
|
AD 서버
|
ADServer | string |
이 필드는 '미리 정의된 AD 서버 선택'이 '수동'(또는 비어 있음)으로 설정된 경우에만 사용됩니다. 모든 추가 Active Directory 작업을 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectorySetADServerResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory 일반 사용자 속성 수정
Active Directory 사용자의 공통 속성을 수정합니다. 속성에만 값을 할당할 수 있으며 값을 공백으로 설정할 수는 없습니다. 속성을 비워 두려면 'Active Directory 사용자 문자열 속성 수정' 작업을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
도시
|
City | string |
사용자의 'City' 속성(AD 사용자 및 컴퓨터의 '주소' 탭)입니다. |
|
|
회사
|
Company | string |
사용자의 '회사' 속성(AD 사용자 및 컴퓨터의 '조직' 탭)입니다. |
|
|
국가 코드
|
Country | string |
사용자의 'Country' 속성(AD 사용자 및 컴퓨터의 '주소' 탭)입니다. 이 코드는 두 개의 문자 국가 코드(예: 영국의 경우 GB, 미국, 프랑스 FR, 스페인 ES, 일본 JP)여야 합니다. Active Directory 스키마의 'c' 속성에 매핑됩니다. IA-Connect '국가 코드'를 '국가 문자열' 및 'Country ISO 3166 값'에 자동으로 매핑하지 않으므로 조회 테이블을 사용해야 합니다. |
|
|
국가 문자열
|
CountryString | string |
AD 사용자 및 컴퓨터의 '주소' 탭에 있는 사용자의 'Country' 속성의 전체 이름입니다. 전체 지역화된 표시 문자열(예: '영국', '미국', '프랑스', '스페인' 또는 '일본')입니다. Active Directory 스키마의 'co' 속성에 매핑됩니다. IA-Connect '국가 문자열'을 '국가 코드' 및 'Country ISO 3166 값'에 자동으로 매핑하지 않으므로 조회 테이블을 사용해야 합니다. |
|
|
국가 ISO 3166 값
|
CountryISO3166 | string |
사용자의 'Country' 속성에 대한 ISO3166 코드입니다(AD 사용자 및 컴퓨터의 '주소' 탭). 이 값은 3자리 정수 값입니다(예: 영국의 경우 826, 미국 840, 프랑스 250, 스페인 724, 일본 392). Active Directory 스키마의 'countryCode' 속성에 매핑됩니다. IA-Connect 'Country ISO 3166 값'을 '국가 코드' 및 '국가 문자열'에 자동으로 매핑하지 않으므로 조회 테이블을 사용해야 합니다. |
|
|
부서
|
Department | string |
사용자의 'Department' 속성(AD 사용자 및 컴퓨터의 '조직' 탭)입니다. |
|
|
Description
|
Description | string |
사용자의 'Description' 속성(AD 사용자 및 컴퓨터의 '일반' 탭)입니다. |
|
|
표시 이름
|
DisplayName | string |
사용자의 표시 이름(AD 사용자 및 컴퓨터의 '일반' 탭)입니다. |
|
|
전자 메일 주소
|
EmailAddress | string |
사용자의 '전자 메일' 속성(AD 사용자 및 컴퓨터의 '일반' 탭)입니다. |
|
|
이름 (이름의 첫 부분)
|
GivenName | string |
사용자의 이름(AD 사용자 및 컴퓨터의 '일반' 탭)입니다. |
|
|
집 전화 번호
|
HomePhone | string |
사용자의 '홈' 전화 번호 속성(AD 사용자 및 컴퓨터의 '전화' 탭)입니다. |
|
|
이니셜
|
Initials | string |
사용자의 이니셜(AD 사용자 및 컴퓨터의 '일반' 탭)입니다. |
|
|
IP 전화 번호
|
IPPhone | string |
사용자의 'IP 전화' 속성(AD 사용자 및 컴퓨터의 '전화' 탭). |
|
|
매니저
|
Manager | string |
사용자의 관리자 속성(AD 사용자 및 컴퓨터의 '조직' 탭)입니다. 관리자를 고유 이름 형식(예: CN=MrBig,OU=London, DC=mydomain,DC=local), GUID 형식, SID 또는 SAMAccountName(예: 'MrBig')으로 지정할 수 있습니다. |
|
|
휴대폰 번호
|
MobilePhone | string |
사용자의 '모바일' 전화 번호 속성(AD 사용자 및 컴퓨터의 '전화' 탭). |
|
|
비고
|
Notes | string |
사용자의 'Notes' 속성(AD 사용자 및 컴퓨터의 '전화' 탭)입니다. Active Directory 스키마의 'info' 속성에 매핑됩니다. |
|
|
사무실
|
Office | string |
사용자의 'Office' 속성(AD 사용자 및 컴퓨터의 '일반' 탭). |
|
|
전화 번호(Office)
|
OfficePhone | string |
사용자의 '전화 번호' 속성(AD 사용자 및 컴퓨터의 '일반' 탭). |
|
|
우편 번호/우편 번호
|
PostalCode | string |
사용자의 '우편 번호' 속성(AD 사용자 및 컴퓨터의 '주소' 탭)입니다. |
|
|
프로필 경로
|
ProfilePath | string |
사용자의 '프로필 경로' 속성(AD 사용자 및 컴퓨터의 '프로필' 탭)입니다. |
|
|
로그온 스크립트
|
ScriptPath | string |
사용자의 '로그온 스크립트' 속성(AD 사용자 및 컴퓨터의 '프로필' 탭). |
|
|
시/도
|
State | string |
사용자의 'State/province' 속성(AD 사용자 및 컴퓨터의 '주소' 탭)입니다. |
|
|
주소
|
StreetAddress | string |
사용자의 '주소' 속성(AD 사용자 및 컴퓨터의 '주소' 탭)입니다. |
|
|
성(姓)
|
Surname | string |
사용자의 '성' 속성(AD 사용자 및 컴퓨터의 '일반' 탭)입니다. |
|
|
직함
|
Title | string |
사용자의 '직종' 속성(AD 사용자 및 컴퓨터의 '조직' 탭)입니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectoryModifyADUserPropertiesResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Active Directory에 연결됨
IA-Connect Active Directory에 연결되어 있는지 보고합니다. 기본적으로 IA-Connect IA-Connect 에이전트가 실행 중인 계정을 사용하여 IA-Connect 에이전트를 실행하는 컴퓨터가 구성원인 도메인에 자동으로 연결됩니다. '자격 증명을 사용하여 Active Directory에 연결' 작업을 사용하여 대체 자격 증명을 사용하거나 대체 도메인에 연결합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Active Directory에 연결됨
|
ActiveDirectoryRunspaceOpen | boolean |
IA-Connect Active Directory에 연결된 경우 true로 설정합니다. IA-Connect 에이전트를 실행하는 컴퓨터가 구성원인 도메인에 자동으로 연결되므로 항상 true를 반환해야 합니다. |
|
로컬 통과 연결
|
ActiveDirectoryLocalPassthroughRunspace | boolean |
IA-Connect 도메인에 연결된 경우 IA-Connect 에이전트를 실행하는 컴퓨터가 구성원인 경우 IA-Connect 에이전트가 실행 중인 계정을 사용하여 true로 설정합니다. |
|
Active Directory 서버
|
ActiveDirectoryServer | string |
연결된 Active Directory 서버입니다. 비어 있는 경우 IA-Connect AD 사이트 설정에 따라 에이전트를 실행하는 컴퓨터에 대해 기본 Active Directory 도메인 컨트롤러를 사용합니다. |
|
Active Directory DNS 도메인
|
ActiveDirectoryDNSDomain | string |
도메인 IA-Connect 대한 Active Directory DNS 도메인이 연결되어 있습니다. 비어 있는 경우 IA-Connect 에이전트를 실행하는 컴퓨터에 대해 기본 Active Directory 도메인을 사용합니다. 예: mydomain.local. |
|
Active Directory 도메인 DN
|
ActiveDirectoryDomainDN | string |
도메인 IA-Connect 대한 Active Directory 도메인 DN이 연결됩니다. 비어 있는 경우 IA-Connect 에이전트를 실행하는 컴퓨터에 대해 기본 Active Directory 도메인을 사용합니다. 예: DC=mydomain,DC=local. |
|
인증된 사용자 이름
|
AuthenticatedUsername | string |
인증된 사용자 이름 IA-Connect Active Directory에 대한 연결에 사용합니다. 비어 있는 경우 IA-Connect IA-Connect 에이전트가 실행 중인 계정을 사용하고 있습니다. |
Active Directory에서 연결 끊기
'자격 증명으로 Active Directory PowerShell Runspace 열기' 작업을 사용하여 Active Directory PowerShell 명령을 대체 사용자 계정 또는 대체 도메인으로 실행한 경우 이 작업은 IA-Connect 에이전트가 실행 중인 사용자 계정으로 Active Directory 작업을 실행하는 기본 동작으로 IA-Connect 에이전트를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
CloseActiveDirectoryPowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD PowerShell 모듈이 설치되어 있나요?
Azure Active Directory에 필요한 PowerShell 모듈(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)이 IA-Connect 에이전트가 실행 중인 컴퓨터에 설치되어 있는지 보고합니다. 이 작업은 Azure AD v2 및 Microsoft Graph 사용자 PowerShell 모듈을 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD v2 PowerShell 모듈이 설치됨
|
AzureADv2PowerShellModuleInstalled | boolean |
Azure AD v2 PowerShell 모듈(AzureAD)이 설치된 경우 true로 설정합니다. |
|
Microsoft Graph 사용자 PowerShell 모듈이 설치됨
|
MSGraphUsersPowerShellModuleInstalled | boolean |
Microsoft Graph 사용자 PowerShell 모듈(Microsoft.Graph.Users 및 Microsoft.Graph.Authentication)이 설치된 경우 true로 설정합니다. |
Azure AD PowerShell 스크립트 실행
IA-Connect 에이전트가 실행되는 세션에서 Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함) Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 지정 Azure AD PowerShell 스크립트를 실행하기 위한 권장 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. 이 작업은 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
PowerShell 스크립트 내용
|
PowerShellScriptContents | string |
Azure AD v2 Runspace에서 실행할 PowerShell 스크립트의 내용입니다. IA-Connect PowerShell 자동화 엔진에 직접 전달하여 이 스크립트 as-is 실행합니다. 실제로 디스크에 PowerShell 스크립트가 만들어지지 않습니다. 또는 return 및 'scriptpath'를 입력하여 디스크에서 기존 PowerShell 스크립트를 실행할 수 있습니다. 예: return & 'c:\scripts\AzureADTestScript.ps1'. |
|
|
결과가 없나요? 오류
|
IsNoResultAnError | boolean |
PowerShell 명령에서 반환되는 데이터가 없는 경우 오류가 발생하나요? |
|
|
복합 형식 반환
|
ReturnComplexTypes | boolean |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. '컬렉션으로 반환할 속성', 'serialize할 속성 이름' 및 '직렬화할 속성 형식'을 입력하면 반환해야 하는 '복합' 속성과 데이터 형식을 지정하는 데 사용되는 메서드를 지정할 수 있습니다(속성별로 가장 적합한 속성 선택). 이 입력을 사용하면 나머지 속성(즉, '복합'이고 명시적으로 이름이 지정되지 않은 속성)을 사용하여 수행해야 하는 작업을 지정할 수 있습니다. true로 설정하면 IA-Connect ToString()을 사용하여 데이터의 문자열 표현을 반환하려고 합니다. false(기본값)로 설정하면 IA-Connect 속성을 반환하지 않습니다. |
|
|
부울을 부울로 반환
|
ReturnBooleanAsBoolean | boolean |
부울 속성을 부울로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
숫자를 10진수로 반환
|
ReturnNumericAsDecimal | boolean |
숫자 속성을 숫자로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
날짜로 반환 날짜
|
ReturnDateAsDate | boolean |
Date 속성을 날짜로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
컬렉션으로 반환할 속성
|
PropertiesToReturnAsCollectionJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 컬렉션으로 반환해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있습니다. 속성, 해당 형식 및 값에 따라 대체 입력 '직렬화할 속성 이름' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 JSON 또는 CSV 형식으로 입력할 수 있습니다. 예를 들어 EmailAddresses 및 MemberOf 배열 속성을 반환하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
스크립트를 스레드로 실행
|
RunScriptAsThread | boolean |
false(기본값)로 설정하면 IA-Connect 에이전트는 PowerShell 스크립트를 즉시 실행하고 스크립트가 완료되면 디렉터에게 결과를 반환합니다. 오래되거나 복잡한 PowerShell 스크립트를 실행하는 경우 이 작업은 시간이 초과할 수 있습니다. true로 설정하면 IA-Connect 에이전트가 PowerShell 스크립트를 에이전트 스레드로 실행하고 IA-Connect 디렉터(또는 Orchestrator, PowerShell 모듈, Blue Prism)가 이 에이전트 스레드의 상태를 모니터링하여 완료될 때까지 대기할 수 있습니다. 이렇게 하면 긴 또는 복잡한 PowerShell 스크립트를 시간 제한 없이 실행할 수 있습니다. IA-Connect 에이전트 9.3 이하에서는 PowerShell 스크립트를 에이전트 스레드로 실행할 수 없습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 PowerShell 스크립트를 에이전트 스레드로 실행하고 '스레드를 기다리는 초'를 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. PowerShell 스크립트를 실행하기만 하면 0(기본값)으로 설정됩니다(따라서 에이전트 스레드로 실행되는 이전 PowerShell 스크립트의 결과를 검색하지 않음). |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 스크립트 실행'이 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 현재 PowerShell 스크립트를 실행하는 에이전트 스레드가 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 계속해서 PowerShell 스크립트를 실행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 에이전트 스레드가 완료되기를 기다리는 '에이전트 스레드가 성공적으로 완료되기를 기다립니다' 작업을 사용하여 나중에 스크립트 결과를 검색한 다음 에이전트 스레드 ID로 설정된 입력 '스레드 ID에 대한 출력 데이터 검색'을 사용하여 이 'PowerShell 스크립트 실행' 작업을 다시 실행할 수 있습니다. |
|
|
스크립트에 저장된 암호가 포함되어 있습니다.
|
ScriptContainsStoredPassword | boolean |
스크립트에 {IAConnectPassword:StoredPasswordIdentifier} 형식의 IA-Connect 저장된 암호 식별자 또는 {OrchestratorCredential:FriendlyName} 형식의 IA-Connect Orchestrator 제네릭 자격 증명이 포함된 경우 true로 설정합니다. { } 구는 지정된 암호로 대체되고 이스케이프되어 작은따옴표로 배치됩니다(스크립트에 이미 따옴표가 없는 경우). |
|
|
자세한 정보 출력 기록
|
LogVerboseOutput | boolean |
powerShell 자세한 정보 출력을 IA-Connect 로그에 기록하려면 true로 설정합니다. 디버깅에 유용할 수 있습니다. 스크립트에서 자세한 내용을 기록하려면 '내 메시지' -자세한 정보 표시를 Write-Verbose PowerShell을 사용합니다. |
|
|
serialize할 속성 이름
|
PropertyNamesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 serialize해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 예를 들어 EmailAddresses 및 MemberOf 속성을 직렬화하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
직렬화할 속성 형식
|
PropertyTypesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 직렬화해야 하는 '복합' 속성(형식별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 이름'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 단일 'PropertyType' 필드가 있는 컬렉션입니다. 예: Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]형식의 속성을 직렬화하려면 [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}]를 입력합니다(JSON 테이블 형식), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"](JSON 배열 형식) 또는 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[](CSV 형식). |
|
|
이름
|
Name | string |
입력 PowerShell 매개 변수의 이름입니다. PowerShell 변수 명명 형식을 충족해야 합니다(즉, 공백 또는 특수 기호를 사용하지 않는 것이 좋습니다). PowerShell 변수 이름은 대/소문자를 구분하지 않습니다. 예를 들어 MyVariable은 변수 $MyVariable 생성됩니다. |
|
|
문자열 값
|
StringValue | string |
입력 PowerShell 매개 변수에 할당할 문자열 값입니다. 또는 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
정수 값
|
IntValue | integer |
입력 PowerShell 매개 변수에 할당할 정수(정수) 값입니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
부울 값
|
BooleanValue | boolean |
입력 PowerShell 매개 변수에 할당할 부울(true 또는 false) 값입니다. 또는 문자열 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
십진수 값
|
DecimalValue | double |
입력 PowerShell 매개 변수에 할당할 10진수 값입니다. 또는 문자열, 부울 또는 정수 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
개체 값
|
ObjectValue | object |
입력 PowerShell 매개 변수에 할당할 개체 값입니다. PowerShell 스크립트에서 JSON 직렬화된 문자열 변수가 되므로 ConvertFrom-Json을 사용하여 개체로 역직렬화합니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
스레드 ID
|
ThreadId | integer |
PowerShell 스크립트를 에이전트 스레드로 실행하는 경우 이 출력에는 PowerShell 스크립트 실행을 모니터링하고 스크립트가 완료될 때 PowerShell 스크립트 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
Azure AD 그룹 가져오기
Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에서 그룹의 세부 정보를 반환합니다. 개체 ID 또는 필터를 사용하여 검색할 수 있습니다. 개체 ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 개체 ID
|
ObjectId | string |
검색할 Azure Active Directory 그룹의 개체 ID입니다. 표시 이름(예: "재무 사용자") 또는 ObjectId(예: UUID/GUID 값)로 그룹을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
그룹 개체 ID로 검색하는 대신 그룹을 필터링할 속성의 이름을 제공합니다. 일반적인 그룹 속성 이름은 Description, DisplayName 및 Mail입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
그룹 개체 ID를 기준으로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 'DisplayName'인 경우 비교는 '같음' 또는 '시작'일 수 있음). 원시 필터(ODATA 3 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
그룹 개체 ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 'DisplayName'인 경우 필터 속성 값은 'London users'일 수 있음). |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
그룹을 찾을 수 없는 경우 예외를 발생하려면 true로 설정합니다. 그룹을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
반환할 속성
|
PropertiesToReturn | string |
반환(검색)할 모든 그룹 속성의 CSV(쉼표로 구분된 목록)입니다. 비어 있는 경우(기본값) IA-Connect 공통 그룹 속성의 기본 집합을 반환합니다. Microsoft Graph 사용자 PowerShell 모듈을 사용하는 경우 입력을 통해 반환된 속성을 제한하거나 추가 속성을 반환할 수 있습니다. Azure AD v2를 사용하는 경우 입력에서는 반환된 속성만 제한할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 검색 개체 ID 또는 필터와 일치하는 그룹 목록입니다. |
|
찾은 그룹 수
|
CountOfGroupsFound | integer |
검색 개체 ID 또는 필터와 일치하는 찾은 그룹 수입니다. |
Azure AD 그룹 구성원 가져오기
Azure Active Directory 그룹의 멤버 목록을 반환합니다. 멤버는 사용자, 그룹, 디바이스 또는 서비스 주체/엔터프라이즈 애플리케이션일 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 개체 ID 또는 UPN
|
GroupObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
반환할 속성
|
PropertiesToReturn | string |
반환(검색)할 모든 멤버 속성의 CSV(쉼표로 구분된 목록)입니다. 비어 있는 경우(기본값) IA-Connect AccountEnabled, DirSyncEnabled, DisplayName, Mail, MailNickName, ObjectId, ObjectType, SecurityEnabled, UserPrincipalName을 반환합니다. *를 입력하여 모든 속성을 받습니다. |
|
|
반환할 멤버 개체 형식
|
MemberObjectTypesToReturn | string |
반환(검색)할 모든 멤버 개체 형식의 CSV(쉼표로 구분된 목록)입니다. 비어 있는 경우(기본값) IA-Connect 사용자, 그룹, 디바이스, ServicePrincipal 중 하나 이상이 될 수 있는 모든 멤버 개체 형식을 반환합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그룹 구성원 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 AD 그룹 멤버 목록입니다. |
|
찾은 그룹 구성원 수
|
CountOfGroupMembersFound | integer |
Azure AD 그룹 구성원의 수입니다. |
Azure AD 라이선스 SKU 가져오기
연결된 Azure AD가 구독하는 Azure Active Directory SKU(Stock Keeping Units) 목록을 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Expand 속성
|
ExpandProperty | string |
출력을 확장하고 포함할 선택적 라이선스 속성입니다. 'PrepaidUnits'를 확장하면 사용 가능한 총 라이선스 수를 포함한 라이선스 정보가 출력에 포함됩니다. 'ServicePlans'를 확장하면 SKU 내의 각 개별 서비스 계획이 별도의 출력 라인 항목으로 반환됩니다. 한 번에 하나의 속성만 확장할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
라이선스 SKU JSON
|
LicenseSKUJSONOutput | string |
구독된 주식 유지 단위 목록(JSON 형식)입니다. |
|
찾은 SKU 수
|
CountOfSKUsFound | integer |
Azure AD 구독 SKU(Stock Keeping Units)의 수입니다. |
Azure AD 보안 또는 Microsoft 365 그룹 제거
Azure Active Directory 보안 그룹 또는 Microsoft 365 그룹을 제거합니다. 이 작업은 메일 사용 보안 그룹 또는 메일 그룹을 제거할 수 없습니다. 대신 'Office 365 메일 그룹 제거' 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 개체 ID 또는 표시 이름
|
GroupObjectId | True | string |
Azure Active Directory 그룹의 ID 또는 표시 이름입니다. 표시 이름(예: "재무 사용자") 또는 ObjectId(예: UUID/GUID 값)로 그룹을 지정할 수 있습니다. |
|
그룹이 없는 경우 예외
|
ErrorIfGroupDoesNotExist | boolean |
그룹이 없는 경우 예외가 발생해야 하나요? 그룹이 없는 경우 아무 작업도 수행하지 않도록 false로 설정합니다(예: 이미 삭제되었을 수 있음). 존재하지 않는 그룹이 오류(예: 존재할 것으로 예상됨)인 경우 true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그룹이 존재했습니다.
|
GroupExisted | boolean |
그룹이 존재하고 삭제된 경우 true로 설정됩니다. 그룹이 존재하지 않는 경우(그리고 '그룹이 존재하지 않는 경우 오류'가 false로 설정되어 예외가 발생하지 않음) 그룹이 존재하지 않음을 알리기 위해 false로 설정되므로 IA-Connect 아무 작업도 수행할 필요가 없습니다. |
Azure AD 사용자 가져오기
Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에서 사용자의 세부 정보를 반환합니다. 개체 ID 또는 필터를 사용하여 검색할 수 있습니다. 개체 ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | string |
검색할 Azure Active Directory 사용자의 개체 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
사용자 개체 ID로 검색하는 대신 사용자를 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 UserPrincipalName 및 DisplayName입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
사용자 개체 ID를 기준으로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 'UserPrincipalName'인 경우 비교는 '같음' 또는 '시작'일 수 있음). 원시 필터(ODATA 3 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
사용자 개체 ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 'UserPrincipalName'인 경우 필터 속성 값은 ''JohnDoe@mydomain.com일 수 있음). |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
사용자를 찾을 수 없는 경우 예외를 발생하려면 true로 설정합니다. 사서함을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
반환할 속성
|
PropertiesToReturn | string |
반환(검색)할 사용자 속성의 쉼표로 구분된 목록입니다. 일반적인 속성은 다음과 같습니다. AccountEnabled, City, CompanyName, Country, Department, DisplayName, GivenName, JobTitle, PostalCode, State, StreetAddress, Surname, UserPrincipalName. 이 필드를 비워 두면 기본 속성 집합이 검색됩니다. 검색할 속성을 지정하면 해당 속성만 검색됩니다. Azure AD v2 PowerShell 모듈을 사용하는 경우에는 아무런 영향이 없습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 검색 필터와 일치하는 사용자 목록입니다. |
|
찾은 사용자 수
|
CountOfUsersFound | integer |
검색 개체 ID, UPN 또는 필터와 일치하는 사용자 수입니다. |
Azure AD 사용자 관리자 역할 할당 가져오기
지정된 사용자가 할당된 Azure Active Directory 관리자 역할 목록을 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
관리자 역할 이름 검색
|
RetrieveAdminRoleNames | boolean |
true로 설정하면 IA-Connect 에이전트는 역할 ID 외에도 각 역할의 이름을 검색합니다. 이 작업은 더 오래 걸리지만 더 읽기 쉬운 정보를 제공합니다. false로 설정하면 IA-Connect 에이전트가 역할 이름을 검색하지 않습니다. |
|
|
할당 ID 반환
|
ReturnAssignmentIds | boolean |
true로 설정하면 IA-Connect 에이전트는 각 역할 할당에 대한 할당 ID를 검색합니다. 할당 ID는 기본 제공 IA-Connect 작업을 사용하는 대신 역할 할당에 대한 사용자 지정 작업을 수행하려는 경우에만 필요합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
역할 할당 JSON
|
PowerShellJSONOutput | string |
JSON 형식으로 사용자에게 할당된 Azure AD 관리자 역할 목록입니다. |
|
찾은 역할 할당 수
|
CountOfRoleAssignmentsFound | integer |
사용자가 할당된 Azure AD 관리자 역할의 수입니다. |
Azure AD 사용자 그룹 멤버 자격 가져오기
지정된 사용자가 구성원인 Azure Active Directory 그룹 목록을 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
반환할 속성
|
PropertiesToReturn | string |
반환(검색)할 모든 그룹 속성의 CSV(쉼표로 구분된 목록)입니다. 비어 있는 경우(기본값) IA-Connect 모든 그룹 속성을 반환합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그룹 멤버 자격 JSON
|
PowerShellJSONOutput | string |
사용자가 멤버인 Azure AD 그룹 목록은 JSON 형식입니다. |
|
찾은 그룹 수
|
CountOfGroupsFound | integer |
사용자가 구성원인 Azure AD 그룹의 수입니다. |
Azure AD 사용자 그룹의 사용자인가요?
사용자가 Azure Active Directory 그룹의 구성원인지 여부를 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
그룹 개체 ID 또는 표시 이름
|
GroupObjectId | True | string |
Azure Active Directory 그룹의 ID 또는 표시 이름입니다. 표시 이름(예: "재무 사용자") 또는 ObjectId(예: UUID/GUID 값)로 그룹을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자가 그룹에 있습니다.
|
UserIsInGroup | boolean |
사용자가 Azure AD 그룹의 구성원인지 여부입니다. |
Azure AD 사용자 라이선스 가져오기
Azure AD 사용자에게 할당된 라이선스 목록(SKU)을 검색합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 라이선스 SKU JSON
|
UserLicenseSKUJSONOutput | string |
JSON 형식으로 사용자에게 할당된 Azure AD 라이선스 SKU 목록입니다. |
|
찾은 사용자 라이선스 SKU 수
|
CountOfUserLicenseSKUsFound | integer |
사용자에게 할당된 Azure AD 라이선스 SKU의 수입니다. |
Azure AD 사용자 라이선스 서비스 계획 가져오기
지정된 Azure AD SKU(사용자 라이선스)에 할당된 라이선스 계획 목록을 검색합니다. 예를 들어 사용자에게 FLOW_FREE 라이선스가 할당된 경우 해당 라이선스에 프로비전한 서비스 계획을 볼 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
라이선스 SKU 파트 번호
|
LicenseSKUPartNumber | True | string |
라이선스 SKU의 파트 번호입니다. 예: FLOW_FREE 또는 SPE_E3. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 라이선스 SKU 서비스 계획 JSON
|
UserLicenseSKUServicePlansJSONOutput | string |
JSON 형식으로 사용자에게 할당된 지정된 Azure AD 라이선스 SKU에 할당된 서비스 계획 목록입니다. |
|
찾은 라이선스 SKU 서비스 계획 수
|
CountOfUserLicenseSKUServicePlansFound | integer |
사용자에게 할당된 지정된 라이선스 SKU에 할당된 Azure AD 서비스 계획의 수입니다. |
Azure AD 사용자 라이선스 설정
Azure AD SKU(사용자 라이선스)를 추가하거나 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
추가할 라이선스
|
LicenseToAdd | string |
추가할 단일 Azure AD 라이선스 SKU입니다. SKU ID(GUID) 또는 SKU 파트 번호(단어)로 입력할 수 있습니다. 예: TEAMS_EXPLORATORY. 여러 라이선스를 사용하도록 설정하려면 라이선스당 한 번씩 이 작업을 호출합니다. |
|
|
추가할 라이선스 계획
|
LicensePlansChoice | string |
일부 라이선스에는 계획이 있습니다. 모든 계획을 사용하도록 설정하려는 경우(또는 모르는 경우) '모두'를 선택합니다. 명명된 특정 계획만 사용하도록 설정하려면 '옵트인'을 선택하고 '라이선스 계획 CSV' 필드에 사용하도록 설정할 계획을 입력합니다. 지정한 플랜을 제외한 모든 플랜을 사용하도록 설정하려면 '옵트아웃'을 선택하고 '라이선스 플랜 CSV' 필드에 사용하지 않도록 설정하는 계획을 입력합니다. |
|
|
라이선스 계획
|
LicensePlansCSV | string |
사용하거나 사용하지 않도록 설정할 라이선스 계획(라이선스 구성 요소)의 CSV(쉼표로 구분된 목록)입니다. 이 필드를 비워 두면 모든 라이선스 계획이 활성화됩니다. SKU ID(GUID) 또는 SKU 파트 번호(단어)로 입력할 수 있습니다. 예: YAMMER_ENTERPRISE,SHAREPOINTSTANDARD. |
|
|
제거할 라이선스
|
LicensesToRemoveCSV | string |
제거할 Azure AD 라이선스 SKU의 쉼표로 구분된 목록입니다. SKU ID(GUID) 또는 SKU 파트 번호(단어)의 쉼표로 구분된 목록으로 입력할 수 있습니다. 예: TEAMS_EXPLORATORY,FLOW_FREE. |
|
|
사용 위치
|
UsageLocation | string |
두 문자 국가 코드(ISO 3166)입니다. 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. 예를 들어 미국(미국), JP(일본), GB(영국), FR(프랑스), IN(인도)입니다. https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes을(를) 참조하세요. 이 값을 설정하지 않으면 사용자에게 사용 위치가 이미 설정되어 있어야 합니다. 그렇지 않으면 라이선스가 적용되지 않습니다. |
|
|
PowerShell 로컬 범위
|
LocalScope | boolean |
기본 Azure AD v2 PowerShell 명령을 로컬 범위에서 실행해야 합니다. 기본적으로 이 설정은 설정되지 않으므로 PowerShell은 기본값으로 돌아갑니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2SetAzureADUserLicenseResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD 사용자 사용
Azure Active Directory 사용자를 사용하도록 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2EnableUserResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD 사용자 사용 안 함
Azure Active Directory 사용자를 사용하지 않도록 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
사용자 새로 고침 토큰 해지
|
RevokeUserRefreshTokens | boolean |
사용자에게 발급된 새로 고침 토큰을 취소하려면 true로 설정하면 열려 있는 세션이 작동을 중지합니다(세션이 새로 고침 토큰을 사용하여 연결을 활성 상태로 유지하려고 할 때). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2DisableUserResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD 사용자 속성 다시 설정
Azure Active Directory 사용자의 공통 속성을 빈 값으로 다시 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
이름 다시 설정
|
ResetFirstName | boolean |
사용자의 이름을 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
성 다시 설정
|
ResetLastName | boolean |
사용자의 가족 이름/성/성을 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
도시 재설정
|
ResetCity | boolean |
true로 설정하여 사용자가 거주하는 도시의 이름을 다시 설정하거나 사무실이 비어 있는 위치를 다시 설정합니다. |
|
|
회사 이름 다시 설정
|
ResetCompanyName | boolean |
사용자가 작업하는 회사의 이름을 비워 두려면 true로 설정합니다. |
|
|
국가 또는 지역 다시 설정
|
ResetCountry | boolean |
true로 설정하여 사용자가 거주하는 국가 또는 지역을 다시 설정하거나 사무실이 비어 있는 위치를 다시 설정합니다. |
|
|
부서 다시 설정
|
ResetDepartment | boolean |
사용자가 회사 내에서 작업하는 부서의 이름을 비워 두려면 true로 설정합니다. |
|
|
팩스 번호 다시 설정
|
ResetFaxNumber | boolean |
팩스(팩스) 전화 번호를 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
작업 제목 다시 설정
|
ResetJobTitle | boolean |
사용자의 직종을 비워 두려면 true로 설정합니다. |
|
|
휴대폰 번호 다시 설정
|
ResetMobilePhone | boolean |
사용자의 휴대폰 번호를 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
사무실 다시 설정
|
ResetOffice | boolean |
사용자가 비어 있는 사무실의 이름을 다시 설정하려면 true로 설정합니다. |
|
|
전화 번호 다시 설정
|
ResetPhoneNumber | boolean |
사용자의 전화 번호를 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
ZIP 또는 우편 번호 다시 설정
|
ResetPostalCode | boolean |
사용자가 거주하는 ZIP 또는 우편 번호 또는 해당 사용자가 근무하는 사무실을 비워 두려면 true로 설정합니다. |
|
|
기본 설정 언어 다시 설정
|
ResetPreferredLanguage | boolean |
사용자의 기본 설정 언어를 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
주 또는 지방 다시 설정
|
ResetState | boolean |
true로 설정하여 사용자가 거주하는 주, 지방 또는 카운티를 다시 설정하거나 사무실이 비어 있는 위치를 다시 설정합니다. |
|
|
주소 재설정
|
ResetStreetAddress | boolean |
true로 설정하여 사용자가 거주하는 거리 주소 또는 사무실 거리 주소를 빈 주소로 다시 설정합니다. |
|
|
사용 위치 다시 설정
|
ResetUsageLocation | boolean |
사용 위치를 공백으로 다시 설정하려면 true로 설정합니다. 이는 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요하므로 빈 값으로 다시 설정하면 중단될 수 있습니다. |
|
|
연령 그룹 다시 설정
|
ResetAgeGroup | boolean |
자녀 보호 목적으로 사용자의 연령 그룹을 공백으로 다시 설정하려면 true로 설정합니다. |
|
|
미성년자에 대해 제공된 다시 설정 동의
|
ResetConsentProvidedForMinor | boolean |
미성년자에 대한 동의가 보호자 통제 목적으로 제공되었는지 여부를 비워 두려면 true로 설정합니다. |
|
|
직원 ID 다시 설정
|
ResetEmployeeId | boolean |
직원 ID를 공백으로 다시 설정하려면 true로 설정합니다. 이를 사용하여 조직의 각 사용자를 고유하게 구분할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2ResetAzureADUserPropertiesResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD 사용자 속성 수정
Azure Active Directory 사용자의 공통 속성을 수정합니다. 빈 값은 값을 변경하지 않고 그대로 두려는 의도로 해석되므로 속성에만 값을 할당하고 값을 비워 두지 않을 수 있습니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
이름 (이름의 첫 부분)
|
FirstName | string |
사용자의 이름입니다. |
|
|
성(姓)
|
LastName | string |
사용자의 가족 이름/성/성입니다. |
|
|
표시 이름
|
DisplayName | string |
이 사용자의 전체 표시 이름입니다. |
|
|
도시
|
City | string |
사용자가 거주하는 도시 또는 해당 사무실의 이름입니다. |
|
|
회사 이름
|
CompanyName | string |
사용자가 작업하는 회사의 이름입니다. |
|
|
국가 또는 지역
|
Country | string |
사용자가 거주하는 국가 또는 지역 또는 해당 사무실이 있는 위치입니다. |
|
|
부서
|
Department | string |
사용자가 회사 내에서 작업하는 부서의 이름입니다. |
|
|
팩스 번호
|
FaxNumber | string |
사용자의 팩스(팩스) 전화 번호입니다. |
|
|
직함
|
JobTitle | string |
사용자의 직호입니다. |
|
|
휴대폰 번호
|
MobilePhone | string |
사용자의 휴대폰 번호입니다. |
|
|
사무실
|
Office | string |
사용자가 작업하는 사무실의 위치입니다. |
|
|
전화번호
|
PhoneNumber | string |
사용자의 전화 번호입니다. |
|
|
ZIP 또는 우편 번호
|
PostalCode | string |
사용자가 거주하는 ZIP 또는 우편 번호 또는 해당 사용자가 근무하는 사무실입니다. |
|
|
기본 설정 언어
|
PreferredLanguage | string |
사용자가 선호하는 언어입니다. 이 코드는 일반적으로 두 문자 언어 코드(ISO 639-1)로 입력되고 대시와 두 문자 대문자 대문자 국가 코드(ISO 3166)로 입력됩니다. 예: en-US, en-GB, fr-FR, ja-JP. |
|
|
시/도
|
State | string |
사용자가 거주하는 주, 지방 또는 카운티 또는 해당 사무실이 있는 위치입니다. |
|
|
주소
|
StreetAddress | string |
사용자가 거주하는 거리 주소 또는 사무실 주소입니다. |
|
|
사용 위치
|
UsageLocation | string |
두 문자 국가 코드(ISO 3166)입니다. 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. 예를 들어 미국(미국), JP(일본), GB(영국), FR(프랑스), IN(인도)입니다. https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes을(를) 참조하세요. |
|
|
연령 그룹
|
AgeGroup | string |
자녀 보호 목적으로 사용자의 연령 그룹입니다. |
|
|
미성년자에 대해 제공된 동의
|
ConsentProvidedForMinor | string |
'연령 그룹'이 '미성년자'인 경우 이 필드를 사용하면 보호자 통제 목적으로 미성년자에 대한 동의가 제공되었는지 여부를 지정할 수 있습니다. |
|
|
메일 애칭
|
MailNickName | string |
사용자의 메일 애칭입니다. |
|
|
직원 ID
|
EmployeeId | string |
직원 ID입니다. 이를 사용하여 조직의 각 사용자를 고유하게 구분할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2SetAzureADUserResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD 사용자 암호 다시 설정
새 암호를 사용하여 Azure Active Directory 사용자의 암호를 다시 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 주 이름
|
UserPrincipalName | True | string |
Azure Active Directory의 사용자 로그온 이름입니다. 일반적으로 'name@domainFQDN' 형식이어야 합니다(예: 'TestUser1@mydomain.onmicrosoft.com'). |
|
새 암호
|
NewPassword | True | password |
새 암호입니다. 이를 지정하고 Azure Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
다음 로그인 시 암호 강제 변경
|
ForceChangePasswordNextLogin | boolean |
사용자가 다음에 로그인할 때 암호를 변경하도록 강제하려면 true로 설정합니다(즉, 여기서 설정되는 새 암호는 사용자가 로그인할 수 있도록 하는 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호인 경우 false로 설정합니다. |
|
|
변경 암호 정책 적용
|
EnforceChangePasswordPolicy | boolean |
사용자 환경에 따라 사용자가 암호, 암호 복구 옵션 및 추가 보안 확인을 변경하는 빈도를 정의할 수 있는 Azure Active Directory 변경 암호 정책을 적용하려면 true로 설정합니다. 이로 인해 사용자에게 추가 정보를 묻는 메시지가 표시될 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2ResetAzureADUserPasswordResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD 사용자 제거
Azure Active Directory 사용자를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
사용자가 없는 경우 예외
|
ErrorIfUserDoesNotExist | boolean |
사용자가 없는 경우 예외가 발생해야 하나요? 사용자가 없는 경우 아무 작업도 수행하지 않도록 false로 설정합니다(예: 이미 삭제되었을 수 있음). 존재하지 않는 사용자가 오류(예: 존재할 것으로 예상됨)인 경우 true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자가 존재했습니다.
|
UserExisted | boolean |
사용자가 존재하고 삭제된 경우 true로 설정됩니다. 사용자가 존재하지 않는 경우(그리고 '사용자가 존재하지 않는 경우 오류'가 false로 설정되어 예외가 발생하지 않음) 사용자가 존재하지 않았음을 알리기 위해 false로 설정되므로 IA-Connect 아무 작업도 수행할 필요가 없습니다. |
Azure AD 사용자 추가
새 Azure Active Directory 사용자 계정을 만듭니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 주 이름
|
UserPrincipalName | True | string |
Azure Active Directory의 사용자 로그온 이름입니다. 일반적으로 'name@domainFQDN' 형식이어야 합니다(예: 'TestUser1@mydomain.onmicrosoft.com'). |
|
계정 사용
|
AccountEnabled | True | boolean |
계정을 만든 직후 사용하도록 설정하려면 true로 설정합니다. 계정을 사용할 수 없도록 설정하려면 false로 설정합니다. 이 옵션은 기본적으로 true로 설정됩니다. |
|
계정 암호
|
AccountPassword | True | password |
사용자 암호입니다. 이를 지정하고 Azure Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
이름 (이름의 첫 부분)
|
FirstName | string |
사용자의 이름입니다. |
|
|
성(姓)
|
LastName | string |
사용자의 가족 이름/성/성입니다. |
|
|
표시 이름
|
DisplayName | True | string |
이 사용자의 전체 표시 이름입니다. |
|
도시
|
City | string |
사용자가 거주하는 도시 또는 해당 사무실의 이름입니다. |
|
|
회사 이름
|
CompanyName | string |
사용자가 작업하는 회사의 이름입니다. |
|
|
국가 또는 지역
|
Country | string |
사용자가 거주하는 국가 또는 지역 또는 해당 사무실이 있는 위치입니다. |
|
|
부서
|
Department | string |
사용자가 회사 내에서 작업하는 부서의 이름입니다. |
|
|
팩스 번호
|
FaxNumber | string |
사용자의 팩스(팩스) 전화 번호입니다. |
|
|
직함
|
JobTitle | string |
사용자의 직호입니다. |
|
|
메일 애칭
|
MailNickName | True | string |
사용자의 메일 애칭입니다. |
|
휴대폰 번호
|
MobilePhone | string |
사용자의 휴대폰 번호입니다. |
|
|
사무실
|
Office | string |
사용자가 작업하는 사무실의 위치입니다. |
|
|
전화번호
|
PhoneNumber | string |
사용자의 전화 번호입니다. |
|
|
ZIP 또는 우편 번호
|
PostalCode | string |
사용자가 거주하는 ZIP 또는 우편 번호 또는 해당 사용자가 근무하는 사무실입니다. |
|
|
기본 설정 언어
|
PreferredLanguage | string |
사용자가 선호하는 언어입니다. 이 코드는 일반적으로 두 문자 언어 코드(ISO 639-1)로 입력되고 대시와 두 문자 대문자 대문자 국가 코드(ISO 3166)로 입력됩니다. 예: en-US, en-GB, fr-FR, ja-JP. |
|
|
시/도
|
State | string |
사용자가 거주하는 주, 지방 또는 카운티 또는 해당 사무실이 있는 위치입니다. |
|
|
주소
|
StreetAddress | string |
사용자가 거주하는 거리 주소 또는 사무실 주소입니다. |
|
|
사용 위치
|
UsageLocation | string |
두 문자 국가 코드(ISO 3166)입니다. 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. 예를 들어 미국(미국), JP(일본), GB(영국), FR(프랑스), IN(인도)입니다. https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes을(를) 참조하세요. |
|
|
연령 그룹
|
AgeGroup | string |
자녀 보호 목적으로 사용자의 연령 그룹입니다. 기본값은 none/지정되지 않은 것이며(컨트롤 관점에서) Adult과 동일합니다. |
|
|
미성년자에 대해 제공된 동의
|
ConsentProvidedForMinor | string |
'연령 그룹'이 '미성년자'인 경우 이 필드를 사용하면 보호자 통제 목적으로 미성년자에 대한 동의가 제공되었는지 여부를 지정할 수 있습니다. |
|
|
직원 ID
|
EmployeeId | string |
선택적 직원 ID입니다. 이를 사용하여 조직의 각 사용자를 고유하게 구분할 수 있습니다. |
|
|
다음 로그인 시 암호 강제 변경
|
ForceChangePasswordNextLogin | boolean |
사용자가 다음에 로그인할 때 암호를 변경하도록 강제하려면 true로 설정합니다(즉, 여기서 설정되는 새 암호는 사용자가 로그인할 수 있도록 하는 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호인 경우 false로 설정합니다. |
|
|
변경 암호 정책 적용
|
EnforceChangePasswordPolicy | boolean |
사용자 환경에 따라 사용자가 암호, 암호 복구 옵션 및 추가 보안 확인을 변경하는 빈도를 정의할 수 있는 Azure Active Directory 변경 암호 정책을 적용하려면 true로 설정합니다. 이로 인해 사용자에게 추가 정보를 묻는 메시지가 표시될 수 있습니다. |
|
|
비밀번호가 만료되지 않음
|
PasswordNeverExpires | boolean |
암호가 만료되지 않는 경우 true로 설정합니다(즉, 사용자에게 암호를 변경하라는 메시지가 표시되지 않음). 암호가 Azure Active Directory 암호 정책에 설정된 대로 만료 될 수 있으면 false로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
만든 사용자 계정 이름
|
CreatedUserPrincipalName | string |
만든 사용자 계정의 Azure Active Directory UPN(사용자 계정 이름)입니다. |
|
만든 사용자 개체 ID
|
CreatedUserObjectId | string |
만든 사용자 계정의 Azure Active Directory 사용자 개체 ID입니다. |
Azure AD 사용자가 관리자 역할에 할당되어 있나요?
Azure Active Directory 사용자가 Azure Active Directory 관리자 역할에 할당되었는지 여부를 반환합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
역할 개체 ID 또는 표시 이름
|
RoleObjectId | True | string |
Azure Active Directory 관리자 역할의 ID 또는 표시 이름입니다. 표시 이름(예: "애플리케이션 개발자") 또는 ObjectId(예: UUID/GUID 값)로 AAD 관리자 역할을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자가 역할에 할당됨
|
UserIsAssignedToRole | boolean |
사용자가 Azure Active Directory 관리자 역할에 할당되었는지 여부입니다. |
Azure AD 사용자의 관리자 설정
Azure Active Directory 사용자의 관리자를 설정합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
매니저
|
Manager | string |
관리자를 추가하려면 사용자의 관리자 개체 ID(예: UUID/GUID 값) 또는 UPN(예: myboss@mydomain.com)을 지정합니다. 사용자의 관리자를 제거하려면 이 필드를 비워 둠으로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2SetAzureADUserManagerResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Azure AD에 연결됨
IA-Connect Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에 연결되어 있는지 보고합니다. 'Azure AD에 연결' 작업 중 하나를 사용하여 연결합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
PowerShell Runspace 프로세스 ID 검색
|
RetrievePowerShellRunSpacePID | boolean |
true로 설정된 경우: IA-Connect 에이전트는 PowerShell Runspace를 호스팅하는 프로세스의 프로세스 ID에 대한 정보를 검색합니다. 이 정보는 'PowerShell Runspace 프로세스 ID' 및 'PowerShell Runspace를 호스트하는 에이전트인가요'의 출력에 제공됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD PowerShell Runspace가 열려 있습니다.
|
AzureADv2RunspaceOpen | boolean |
IA-Connect Azure AD에 연결된 경우 true로 설정합니다. Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용할 수 있습니다. |
|
Azure AD API
|
AzureADAPI | string |
사용 중인 Azure AD API의 이름입니다. Azure AD v2 PowerShell 모듈을 사용하는 경우 'AzureADv2'로 설정되고, Microsoft Graph Users PowerShell 모듈을 사용하는 경우 'MSGraphUsersPS'로 설정됩니다. |
|
PowerShell Runspace 프로세스 ID
|
PowerShellRunspacePID | integer |
PowerShell RUNSPACE 프로세스 ID(PID)입니다. IA-Connect 에이전트가 PowerShell Runspace를 호스팅하는 경우 이 값은 IA-Connect 에이전트의 PID가 됩니다. PowerShell Runspace가 격리된 경우 이 값은 격리 프로세스의 PID가 됩니다. |
|
PowerShell Runspace를 호스트하는 에이전트인가요?
|
IsAgentHostingPowerShellRunSpace | boolean |
IA-Connect 에이전트가 PowerShell Runspace를 호스팅하는 경우(예: 'PowerShell Runspace 프로세스 ID'가 에이전트 PID인 경우) true를 반환합니다. |
Azure AD에서 연결 끊기
Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에서 IA-Connect 연결을 끊습니다. 다시 연결할 때까지 Azure AD 작업을 다시 실행할 수 없습니다. 이 작업은 원래 연결하는 데 사용되었던 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
CloseAzureADv2PowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
DN에서 Active Directory 도메인 FQDN 가져오기
유틸리티 함수입니다. Active Directory 사용자의 DN(고유 이름)이 지정된 경우 사용자가 포함된 Active Directory 도메인을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 DN
|
DN | True | string |
검색 사용자의 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
도메인 FQDN
|
DomainFQDN | string |
사용자를 포함하는 Active Directory 도메인입니다. |
Exchange PowerShell 스크립트 실행
IA-Connect 에이전트가 실행되는 세션의 Exchange Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 고유의 사용자 지정 Exchange PowerShell 코드를 실행하는 데 권장되는 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
PowerShell 스크립트 내용
|
PowerShellScriptContents | string |
Exchange Runspace에서 실행할 PowerShell 스크립트의 내용입니다. IA-Connect PowerShell 자동화 엔진에 직접 전달하여 이 스크립트 as-is 실행합니다. 실제로 디스크에 PowerShell 스크립트가 만들어지지 않습니다. 또는 return 및 'scriptpath'를 입력하여 디스크에서 기존 PowerShell 스크립트를 실행할 수 있습니다. 예: return & 'c:\scripts\ExchangeTestScript.ps1'. |
|
|
결과가 없나요? 오류
|
IsNoResultAnError | boolean |
PowerShell 명령에서 반환되는 데이터가 없는 경우 오류가 발생하나요? |
|
|
복합 형식 반환
|
ReturnComplexTypes | boolean |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. '컬렉션으로 반환할 속성', 'serialize할 속성 이름' 및 '직렬화할 속성 형식'을 입력하면 반환해야 하는 '복합' 속성과 데이터 형식을 지정하는 데 사용되는 메서드를 지정할 수 있습니다(속성별로 가장 적합한 속성 선택). 이 입력을 사용하면 나머지 속성(즉, '복합'이고 명시적으로 이름이 지정되지 않은 속성)을 사용하여 수행해야 하는 작업을 지정할 수 있습니다. true로 설정하면 IA-Connect ToString()을 사용하여 데이터의 문자열 표현을 반환하려고 합니다. false(기본값)로 설정하면 IA-Connect 속성을 반환하지 않습니다. |
|
|
부울을 부울로 반환
|
ReturnBooleanAsBoolean | boolean |
부울 속성을 부울로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
숫자를 10진수로 반환
|
ReturnNumericAsDecimal | boolean |
숫자 속성을 숫자로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
날짜로 반환 날짜
|
ReturnDateAsDate | boolean |
Date 속성을 날짜로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
컬렉션으로 반환할 속성
|
PropertiesToReturnAsCollectionJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 컬렉션으로 반환해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있습니다. 속성, 해당 형식 및 값에 따라 대체 입력 '직렬화할 속성 이름' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 JSON 또는 CSV 형식으로 입력할 수 있습니다. 예를 들어 EmailAddresses 및 MemberOf 배열 속성을 반환하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
스크립트를 스레드로 실행
|
RunScriptAsThread | boolean |
false(기본값)로 설정하면 IA-Connect 에이전트는 PowerShell 스크립트를 즉시 실행하고 스크립트가 완료되면 디렉터에게 결과를 반환합니다. 오래되거나 복잡한 PowerShell 스크립트를 실행하는 경우 이 작업은 시간이 초과할 수 있습니다. true로 설정하면 IA-Connect 에이전트가 PowerShell 스크립트를 에이전트 스레드로 실행하고 IA-Connect 디렉터(또는 Orchestrator, PowerShell 모듈, Blue Prism)가 이 에이전트 스레드의 상태를 모니터링하여 완료될 때까지 대기할 수 있습니다. 이렇게 하면 긴 또는 복잡한 PowerShell 스크립트를 시간 제한 없이 실행할 수 있습니다. IA-Connect 에이전트 9.3 이하에서는 PowerShell 스크립트를 에이전트 스레드로 실행할 수 없습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 PowerShell 스크립트를 에이전트 스레드로 실행하고 '스레드를 기다리는 초'를 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. PowerShell 스크립트를 실행하기만 하면 0(기본값)으로 설정됩니다(따라서 에이전트 스레드로 실행되는 이전 PowerShell 스크립트의 결과를 검색하지 않음). |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 스크립트 실행'이 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 현재 PowerShell 스크립트를 실행하는 에이전트 스레드가 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 계속해서 PowerShell 스크립트를 실행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 에이전트 스레드가 완료되기를 기다리는 '에이전트 스레드가 성공적으로 완료되기를 기다립니다' 작업을 사용하여 나중에 스크립트 결과를 검색한 다음 에이전트 스레드 ID로 설정된 입력 '스레드 ID에 대한 출력 데이터 검색'을 사용하여 이 'PowerShell 스크립트 실행' 작업을 다시 실행할 수 있습니다. |
|
|
스크립트에 저장된 암호가 포함되어 있습니다.
|
ScriptContainsStoredPassword | boolean |
스크립트에 {IAConnectPassword:StoredPasswordIdentifier} 형식의 IA-Connect 저장된 암호 식별자 또는 {OrchestratorCredential:FriendlyName} 형식의 IA-Connect Orchestrator 제네릭 자격 증명이 포함된 경우 true로 설정합니다. { } 구는 지정된 암호로 대체되고 이스케이프되어 작은따옴표로 배치됩니다(스크립트에 이미 따옴표가 없는 경우). |
|
|
자세한 정보 출력 기록
|
LogVerboseOutput | boolean |
powerShell 자세한 정보 출력을 IA-Connect 로그에 기록하려면 true로 설정합니다. 디버깅에 유용할 수 있습니다. 스크립트에서 자세한 내용을 기록하려면 '내 메시지' -자세한 정보 표시를 Write-Verbose PowerShell을 사용합니다. |
|
|
serialize할 속성 이름
|
PropertyNamesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 serialize해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 예를 들어 EmailAddresses 및 MemberOf 속성을 직렬화하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
직렬화할 속성 형식
|
PropertyTypesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 직렬화해야 하는 '복합' 속성(형식별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 이름'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 단일 'PropertyType' 필드가 있는 컬렉션입니다. 예: Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]형식의 속성을 직렬화하려면 [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}]를 입력합니다(JSON 테이블 형식), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"](JSON 배열 형식) 또는 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[](CSV 형식). |
|
|
이름
|
Name | string |
입력 PowerShell 매개 변수의 이름입니다. PowerShell 변수 명명 형식을 충족해야 합니다(즉, 공백 또는 특수 기호를 사용하지 않는 것이 좋습니다). PowerShell 변수 이름은 대/소문자를 구분하지 않습니다. 예를 들어 MyVariable은 변수 $MyVariable 생성됩니다. |
|
|
문자열 값
|
StringValue | string |
입력 PowerShell 매개 변수에 할당할 문자열 값입니다. 또는 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
정수 값
|
IntValue | integer |
입력 PowerShell 매개 변수에 할당할 정수(정수) 값입니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
부울 값
|
BooleanValue | boolean |
입력 PowerShell 매개 변수에 할당할 부울(true 또는 false) 값입니다. 또는 문자열 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
십진수 값
|
DecimalValue | double |
입력 PowerShell 매개 변수에 할당할 10진수 값입니다. 또는 문자열, 부울 또는 정수 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
개체 값
|
ObjectValue | object |
입력 PowerShell 매개 변수에 할당할 개체 값입니다. PowerShell 스크립트에서 JSON 직렬화된 문자열 변수가 되므로 ConvertFrom-Json을 사용하여 개체로 역직렬화합니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
스레드 ID
|
ThreadId | integer |
PowerShell 스크립트를 에이전트 스레드로 실행하는 경우 이 출력에는 PowerShell 스크립트 실행을 모니터링하고 스크립트가 완료될 때 PowerShell 스크립트 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
Exchange를 설정하여 전체 Active Directory 포리스트 보기
Exchange 작업을 수행할 때 전체 Active Directory 포리스트(하위 도메인 포함)를 검색/볼지 여부를 지정합니다. 연결된 도메인이 여러개 있는 경우 이 작업을 사용해야 할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전체 포리스트 보기
|
ViewEntireForest | True | boolean |
전체 Active Directory 포리스트를 검색하려면 true로 설정하고, 현재 Active Directory 도메인만 검색하려면 false로 설정합니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeSetADServerToViewEntireForestResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
JML 환경에 연결
해당 환경의 세부 정보가 IA-Connect Orchestrator에서 유지되는 JML 환경에 연결합니다. 이러한 세부 정보에는 자격 증명, 주소 및 기타 연결 설정이 포함될 수 있습니다. 예를 들어 이 작업을 사용하여 Active Directory, Microsoft Exchange, Azure AD 또는 Office 365 Exchange Online에 연결할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
친근한 이름
|
FriendlyName | string |
IA-Connect Orchestrator에 보관된 JML 환경의 이름입니다. |
|
|
연결되지 않은 경우에만 연결
|
OnlyConnectIfNotAlreadyConnected | boolean |
Exchange 및 Office 365 Exchange Online에만 적용됩니다. false로 설정된 경우: 이 작업은 IA-Connect 이미 연결된 경우에도 항상 Exchange 또는 Office 365 Exchange Online에 연결됩니다. true(기본값):IA-Connect 동일한 설정으로 Exchange 또는 Office 365 Exchange Online에 이미 연결되어 있고 Exchange 연결이 응답하는 경우 IA-Connect 연결이 이미 설정되어 있으므로 아무 작업도 수행하지 않습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
JMLConnectToJMLEnvironmentResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange Online 사서함 및 사용자 계정 만들기
온-프레미스 Active Directory에서 메일 사용 가능 사용자를 만들고 Microsoft Exchange Online 또는 Office 365에서 연결된 원격 사서함을 만듭니다. 사용자가 온-프레미스 Active Directory에 없는 경우에만 이 작업을 사용합니다. 사용자가 이미 있는 경우 '사용자에 대한 Microsoft Exchange Online 사서함 만들기' 작업을 사용합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름 (이름의 첫 부분)
|
FirstName | string |
사용자의 이름입니다. |
|
|
성(姓)
|
LastName | string |
사용자의 성/성입니다. |
|
|
조직 구성 단위
|
OnPremisesOrganizationalUnit | string |
사용자를 고유 이름 형식(예: OU=Target OU,OU=London, DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyUsers\London)로 저장할 OU(조직 단위)입니다. 이 값을 비워 두면 사용자가 '사용자' OU에 만들어집니다. |
|
|
이름
|
Name | True | string |
Active Directory 사용자의 이름입니다. 이는 AD 사용자 및 컴퓨터의 '이름' 열과 사용자 '일반' 탭의 맨 위에 나타납니다. 사용자 로그온 이름이 아닙니다. |
|
표시 이름
|
DisplayName | string |
선택적 사용자 표시 이름입니다. |
|
|
원격 라우팅 주소
|
RemoteRoutingAddress | string |
이 사용자가 연결된 Microsoft Exchange Online 또는 Office 365에서 사서함의 SMTP 주소를 재정의하도록 설정합니다. 이 필드를 비워 두면(기본값) 원격 라우팅 주소는 온-프레미스와 Microsoft Exchange Online 간의 디렉터리 동기화에 따라 자동으로 계산됩니다. |
|
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. |
|
|
사용자 주 이름
|
UserPrincipalName | True | string |
Active Directory의 사용자 로그온 이름입니다. 일반적으로 'name@domainFQDN' 형식이어야 합니다(예: 'TestUser1@domain.local'). 사용자는 name@domainFQDN 형식을 사용하여 로그온할 수 있습니다. |
|
SAM 계정 이름
|
SamAccountName | string |
Active Directory의 사용자 로그온 이름(Windows 2000 이전)입니다. 'name' 형식입니다(예: 'TestUser1'). 사용자는 도메인\name 형식을 사용하여 로그온할 수 있습니다. |
|
|
계정 암호
|
Password | password |
사용자 암호입니다. 이를 지정하고 Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
다음 로그온할 때 반드시 암호 변경
|
ResetPasswordOnNextLogon | boolean |
사용자가 로그인할 때 암호를 변경하도록 강제하려면 true로 설정합니다(즉, 여기에 설정된 새 암호는 사용자가 로그인하도록 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호인 경우 false로 설정합니다. |
|
|
공유 사서함인가요?
|
SharedMailbox | boolean |
만드는 사서함이 공유 사서함이어야 하는 경우 true로 설정합니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
보관 사서함 만들기
|
Archive | boolean |
Microsoft Exchange Online 또는 Office 365에서 보관 사서함을 추가로 만들려면 true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
새 원격 사서함 작업의 출력(JSON 형식)입니다. |
|
새 사서함 DN
|
NewMailboxDN | string |
새로 만든 사서함의 DN(고유 이름)입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 GUID
|
NewMailboxGUID | string |
새로 만든 사서함의 GUID입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
Microsoft Exchange Online 사서함 세부 정보 검색
지정한 Microsoft Exchange Online 또는 Office 365(원격) 사서함의 속성을 반환합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 사서함을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 이름, 별칭, PrimarySMTPAddress, DisplayName입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
사서함이 없는 경우 예외를 발생하려면 true로 설정합니다. 사서함을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
검색 ID와 일치하는 Microsoft Exchange Online 또는 Office 365 사서함(및 요청된 속성) 목록(JSON 형식)입니다. |
|
찾은 사서함 수
|
CountOfMailboxesFound | integer |
검색 ID 또는 필터와 일치하는 Microsoft Exchange Online 또는 Office 365 사서함의 수입니다. 일반적으로 1. |
Microsoft Exchange Online 사서함 전자 메일 주소 검색
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함에 할당된 모든 전자 메일 주소 목록을 검색합니다. 여기에는 기본 SMTP 주소, 프록시 전자 메일 주소, X.400 주소 및 EUM(Exchange 통합 메시징) 주소가 포함됩니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함 전자 메일 주소
|
MailboxEmailAddresses | array of string |
사서함 전자 메일 주소입니다. 기본 SMTP 전자 메일 주소는 SMTP:emailaddress로 표시되고, 보조(프록시) SMTP 전자 메일 주소는 smtp:emailaddress로 표시되고, X.400 전자 메일 주소는 x400:address로 표시되고 EUM(Exchange Unified Messaging) 주소는 eum:address로 표시됩니다. |
Microsoft Exchange Online 사서함 전자 메일 주소 수정
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함에서 전자 메일 주소를 수정합니다. 기본 및 별칭 전자 메일 주소를 추가, 제거 및 바꿀 수 있습니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
추가할 전자 메일 주소
|
EmailAddressesToAddList | array of string |
사서함에 할당할 추가(기본이 아닌) 전자 메일 주소 목록입니다. |
|
|
전자 메일 주소 바꾸기
|
ReplaceEmailAddresses | boolean |
제공된 전자 메일 주소 목록을 기존 전자 메일 주소(기본 SMTP 주소 제외)를 모두 바꾸려면 true로 설정합니다. 제공된 전자 메일 주소 목록을 기존 주소에 추가하려면 false로 설정합니다. |
|
|
제거할 전자 메일 주소
|
EmailAddressesToRemoveList | array of string |
사서함에서 제거할 추가(기본이 아닌) 전자 메일 주소 목록입니다(있는 경우). '전자 메일 주소 바꾸기'가 false로 설정되거나 전자 메일 주소를 추가하지 않는 경우에만 목적이 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함 전자 메일 주소
|
MailboxEmailAddresses | array of string |
수정 작업이 수행된 후의 사서함 전자 메일 주소입니다. 기본 SMTP 전자 메일 주소는 SMTP:emailaddress로 표시되고, 보조(프록시) SMTP 전자 메일 주소는 smtp:emailaddress로 표시되고, X.400 전자 메일 주소는 x400:address로 표시되고 EUM(Exchange Unified Messaging) 주소는 eum:address로 표시됩니다. |
Microsoft Exchange Online 사서함의 속성 다시 설정
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함의 지정된 속성을 공백으로 설정합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
사용자 지정 특성 다시 설정 1
|
ResetCustomAttribute1 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 2
|
ResetCustomAttribute2 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 3
|
ResetCustomAttribute3 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 4
|
ResetCustomAttribute4 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 5
|
ResetCustomAttribute5 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 6
|
ResetCustomAttribute6 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 7
|
ResetCustomAttribute7 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 8
|
ResetCustomAttribute8 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 9
|
ResetCustomAttribute9 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 10
|
ResetCustomAttribute10 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 11
|
ResetCustomAttribute11 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 12
|
ResetCustomAttribute12 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 13
|
ResetCustomAttribute13 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 14
|
ResetCustomAttribute14 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 15
|
ResetCustomAttribute15 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeResetRemoteMailboxAttributesResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange Online 사서함의 속성 설정
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함의 속성을 설정합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
표시 이름
|
DisplayName | string |
사서함의 표시 이름입니다. 주소 목록에 표시됩니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
사서함 유형
|
Type | string |
사서함의 유형입니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
주소 목록에서 숨김
|
HiddenFromAddressListsEnabled | boolean |
주소 목록에서 사서함을 숨기려면 true로, 사서함을 주소 목록에 표시하려면 false로 설정하거나 현재 설정을 그대로 두는 값을 지정하지 않습니다. |
|
|
사용자 지정 특성 1
|
CustomAttribute1 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 2
|
CustomAttribute2 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 3
|
CustomAttribute3 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 4
|
CustomAttribute4 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 5
|
CustomAttribute5 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 6
|
CustomAttribute6 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 7
|
CustomAttribute7 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 8
|
CustomAttribute8 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 9
|
CustomAttribute9 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 10
|
CustomAttribute10 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 11
|
CustomAttribute11 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 12
|
CustomAttribute12 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 13
|
CustomAttribute13 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 14
|
CustomAttribute14 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 15
|
CustomAttribute15 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeSetRemoteMailboxResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange Online 사서함이 있나요?
지정한 Microsoft Exchange Online 또는 Office 365(원격) 사서함이 있는지 여부를 반환합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 사서함을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 이름, 별칭, PrimarySMTPAddress, DisplayName입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함이 있음
|
MailboxExists | boolean |
True이면 Microsoft Exchange Online 사서함이 있습니다. Microsoft Exchange Online 사서함이 없으면 False입니다. |
Microsoft Exchange 메일 그룹 구성원 가져오기
Microsoft Exchange 메일 그룹의 구성원 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | True | string |
검색할 메일 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메일 그룹 구성원
|
DistributionGroupMembersJSON | string |
Exchange 메일 그룹의 멤버 목록(JSON 형식)입니다. |
|
메일 그룹 멤버 수
|
CountOfDistributionGroupsMembers | integer |
Microsoft Exchange 메일 그룹의 구성원 수입니다. |
Microsoft Exchange 메일 그룹 세부 정보 검색
Microsoft Exchange 메일 그룹의 세부 정보를 검색합니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | string |
검색할 메일 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 메일 그룹을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 DisplayName, Name, GroupType, PrimarySMTPAddress입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
메일 그룹을 찾을 수 없는 경우 예외를 발생하려면 true로 설정합니다. 메일 그룹을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 검색 ID 또는 필터와 일치하는 Microsoft Exchange 메일 그룹의 목록입니다. |
|
찾은 메일 그룹 수
|
CountOfDistributionGroupsFound | integer |
검색 ID 또는 필터와 일치하는 Microsoft Exchange 메일 그룹의 수입니다. 일반적으로 1. |
Microsoft Exchange 메일 그룹 제거
Microsoft Exchange 메일 그룹을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | True | string |
메일 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
보안 그룹 관리자 검사 무시
|
BypassSecurityGroupManagerCheck | boolean |
기본적으로 IA-Connect 에이전트 자동화 계정이 메일 그룹의 소유자가 아닌 경우 메일 그룹을 제거할 수 없습니다. 또는 이 옵션을 true로 설정하면 해당 검사가 제거되지만 자동화 계정이 Exchange '조직 관리' 역할 그룹에 있거나 '역할 관리' 역할이 할당되어야 합니다. 이는 수정해야 하는 모든 메일 그룹의 소유자가 아닌 Exchange 메일 그룹을 수정할 수 있는 권한을 부여하는 단일 역할입니다. |
|
|
그룹이 없는 경우 예외
|
ErrorIfGroupDoesNotExist | boolean |
그룹이 없는 경우 예외가 발생해야 하나요? 그룹이 없는 경우 아무 작업도 수행하지 않도록 false로 설정합니다(예: 이미 삭제되었을 수 있음). 존재하지 않는 그룹이 오류(예: 존재할 것으로 예상됨)인 경우 true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeRemoveDistributionGroupResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange 사서함 권한 추가
Active Directory 개체(예: 사용자 또는 그룹)에 사서함 권한을 할당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
Active Directory 개체
|
User | True | string |
권한을 할당할 Active Directory 개체(예: 사용자 또는 그룹)입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사용자를 지정할 수 있습니다. |
|
액세스 권한
|
AccessRights | string |
사서함에 대한 사용자의 권한에 할당할 액세스 권한입니다. 사용 가능한 옵션은 'AccessSystemSecurity'입니다. 'CreateChild', 'DeleteChild', 'ListChildren', 'Self', 'ReadProperty', 'WriteProperty', 'DeleteTree', 'ListObject', 'ExtendedRight', 'Delete', 'ReadControl', 'GenericExecute', 'GenericWrite', 'GenericRead', 'WriteDacl', 'WriteOwner', 'GenericAll' 및 'Synchronize'. |
|
|
확장된 권한
|
ExtendedRights | string |
사서함에 대한 사용자의 권한에 할당할 수 있는 선택적 확장 권한입니다. 확장 권한에는 '다른 이름으로 보내기'가 포함되었습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeAddADPermissionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange 사서함 메일 그룹 멤버 자격 검색
사서함이 구성원인 메일 그룹을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
사서함이 JSON 형식의 구성원인 Microsoft Exchange 메일 그룹 목록입니다. |
|
찾은 메일 그룹 수
|
CountOfDistributionGroupsFound | integer |
사서함이 구성원인 Microsoft Exchange 메일 그룹의 수입니다. |
Microsoft Exchange 사서함 및 사용자 계정 만들기
온-프레미스 Active Directory에서 메일 사용 가능 사용자를 만들고 Microsoft Exchange에서 연결된 사서함을 만듭니다. 사용자가 온-프레미스 Active Directory에 없는 경우에만 이 작업을 사용합니다. 사용자가 이미 있는 경우 '사용자에 대한 Microsoft Exchange 사서함 만들기' 작업을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름 (이름의 첫 부분)
|
FirstName | string |
사용자의 이름입니다. |
|
|
성(姓)
|
LastName | string |
사용자의 성/성입니다. |
|
|
조직 구성 단위
|
OrganizationalUnit | string |
사용자를 고유 이름 형식(예: OU=Target OU,OU=London, DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyUsers\London)로 저장할 OU(조직 단위)입니다. 이 값을 비워 두면 사용자가 '사용자' OU에 만들어집니다. |
|
|
이름
|
Name | True | string |
Active Directory 사용자의 이름입니다. 이는 AD 사용자 및 컴퓨터의 '이름' 열과 사용자 '일반' 탭의 맨 위에 나타납니다. 사용자 로그온 이름이 아닙니다. |
|
표시 이름
|
DisplayName | string |
선택적 사용자 표시 이름입니다. |
|
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. |
|
|
사용자 주 이름
|
UserPrincipalName | True | string |
Active Directory의 사용자 로그온 이름입니다. 일반적으로 'name@domainFQDN' 형식이어야 합니다(예: 'TestUser1@domain.local'). 사용자는 name@domainFQDN 형식을 사용하여 로그온할 수 있습니다. |
|
SAM 계정 이름
|
SamAccountName | string |
Active Directory의 사용자 로그온 이름(Windows 2000 이전)입니다. 'name' 형식입니다(예: 'TestUser1'). 사용자는 도메인\name 형식을 사용하여 로그온할 수 있습니다. |
|
|
계정 암호
|
Password | password |
사용자 암호입니다. 이를 지정하고 Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
다음 로그온할 때 반드시 암호 변경
|
ResetPasswordOnNextLogon | boolean |
사용자가 로그인할 때 암호를 변경하도록 강제하려면 true로 설정합니다(즉, 여기에 설정된 새 암호는 사용자가 로그인하도록 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호인 경우 false로 설정합니다. |
|
|
데이터베이스
|
Database | string |
새 데이터베이스를 포함할 Exchange 데이터베이스입니다. 고유 이름, GUID 또는 이름으로 데이터베이스를 지정할 수 있습니다. |
|
|
공유 사서함인가요?
|
SharedMailbox | boolean |
만드는 사서함이 공유 사서함이어야 하는 경우 true로 설정합니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
보관 사서함 만들기
|
Archive | boolean |
Microsoft Exchange Online 또는 Office 365에서 보관 사서함을 추가로 만들려면 true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
새 사서함 작업의 출력(JSON 형식)입니다. |
|
새 사서함 DN
|
NewMailboxDN | string |
새로 만든 사서함의 DN(고유 이름)입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 GUID
|
NewMailboxGUID | string |
새로 만든 사서함의 GUID입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
Microsoft Exchange 사서함 세부 정보 검색
지정된 Exchange 사서함의 속성을 반환합니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 사서함을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
받는 사람 유형 세부 정보
|
RecipientTypeDetails | string |
검색할 사서함의 유형입니다. 이 필드를 비워 두면 모든 유형의 사서함이 검색에 포함됩니다. |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
사서함이 없는 경우 예외를 발생하려면 true로 설정합니다. 사서함을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
검색 ID와 일치하는 Exchange 사서함(및 요청된 속성) 목록(JSON 형식)입니다. |
|
찾은 사서함 수
|
CountOfMailboxesFound | integer |
검색 ID 또는 필터와 일치하는 Exchange 사서함의 수입니다. ID로 검색하는 경우 1 결과가 필요합니다. 필터로 검색하는 경우 0개 이상의 결과가 예상됩니다. |
Microsoft Exchange 사서함 전자 메일 주소 검색
Microsoft Exchange 사서함에 할당된 모든 전자 메일 주소 목록을 검색합니다. 여기에는 기본 SMTP 주소, 프록시 전자 메일 주소, X.400 주소 및 EUM(Exchange 통합 메시징) 주소가 포함됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함 전자 메일 주소
|
MailboxEmailAddresses | array of string |
사서함 전자 메일 주소입니다. 기본 SMTP 전자 메일 주소는 SMTP:emailaddress로 표시되고, 보조(프록시) SMTP 전자 메일 주소는 smtp:emailaddress로 표시되고, X.400 전자 메일 주소는 x400:address로 표시되고 EUM(Exchange Unified Messaging) 주소는 eum:address로 표시됩니다. |
Microsoft Exchange 사서함 전자 메일 주소 수정
Microsoft Exchange 사서함의 전자 메일 주소를 수정합니다. 기본 및 별칭 전자 메일 주소를 추가, 제거 및 바꿀 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
추가할 전자 메일 주소
|
EmailAddressesToAddList | array of string |
사서함에 할당할 추가(기본이 아닌) 전자 메일 주소 목록입니다. |
|
|
전자 메일 주소 바꾸기
|
ReplaceEmailAddresses | boolean |
제공된 전자 메일 주소 목록을 기존 전자 메일 주소(기본 SMTP 주소 제외)를 모두 바꾸려면 true로 설정합니다. 제공된 전자 메일 주소 목록을 기존 주소에 추가하려면 false로 설정합니다. |
|
|
제거할 전자 메일 주소
|
EmailAddressesToRemoveList | array of string |
사서함에서 제거할 추가(기본이 아닌) 전자 메일 주소 목록입니다(있는 경우). '전자 메일 주소 바꾸기'가 false로 설정되거나 전자 메일 주소를 추가하지 않는 경우에만 목적이 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함 전자 메일 주소
|
MailboxEmailAddresses | array of string |
수정 작업이 수행된 후의 사서함 전자 메일 주소입니다. 기본 SMTP 전자 메일 주소는 SMTP:emailaddress로 표시되고, 보조(프록시) SMTP 전자 메일 주소는 smtp:emailaddress로 표시되고, X.400 전자 메일 주소는 x400:address로 표시되고 EUM(Exchange Unified Messaging) 주소는 eum:address로 표시됩니다. |
Microsoft Exchange 사서함에 대한 자동 회신(부재 중) 설정
Microsoft Exchange 사서함에 대한 자동 회신(부재 중)을 설정합니다. 이 작업은 Microsoft Exchange Online 또는 Office 365의 원격 사서함에서 작동하지 않습니다. 대신 'Office 365 사서함에 대해 자동 회신 설정(부재 중)' 작업을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
자동 회신 상태
|
AutoReplyState | True | string |
자동 회신을 사용하거나 사용하지 않도록 설정할 수 있습니다. |
|
내부 메시지
|
InternalMessage | string |
내부 보낸 사람에게 보낼 자동 회신(부재 중) 메시지입니다. 메시지를 제거하려면 공백으로 설정합니다. |
|
|
외부 대상 그룹
|
ExternalAudience | string |
자동 회신을 외부 대상 그룹에 보낼지 여부를 지정할 수 있습니다. 기본적으로 회신은 모든 외부 보낸 사람에게 전송됩니다. |
|
|
외부 메시지
|
ExternalMessage | string |
외부 대상 그룹을 '모두' 또는 '알려진'으로 설정한 경우 외부 보낸 사람에게 보낼 자동 회신(부재 중) 메시지입니다. 메시지를 제거하려면 공백으로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeSetMailboxAutoReplyConfigurationResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange 사서함의 속성 다시 설정
기존 Microsoft Exchange 사서함의 지정된 속성을 비워 둠으로 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
사용자 지정 특성 다시 설정 1
|
ResetCustomAttribute1 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 2
|
ResetCustomAttribute2 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 3
|
ResetCustomAttribute3 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 4
|
ResetCustomAttribute4 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 5
|
ResetCustomAttribute5 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 6
|
ResetCustomAttribute6 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 7
|
ResetCustomAttribute7 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 8
|
ResetCustomAttribute8 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 9
|
ResetCustomAttribute9 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 10
|
ResetCustomAttribute10 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 11
|
ResetCustomAttribute11 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 12
|
ResetCustomAttribute12 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 13
|
ResetCustomAttribute13 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 14
|
ResetCustomAttribute14 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
사용자 지정 특성 다시 설정 15
|
ResetCustomAttribute15 | boolean |
사용자 지정 특성 필드를 다시 설정하려는 경우 true로 설정합니다(빈 값으로 설정). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeResetMailboxAttributesResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange 사서함의 속성 설정
기존 Microsoft Exchange 사서함의 속성을 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
계정 사용 안 함
|
AccountDisabled | boolean |
계정을 사용하지 않도록 설정하려면 true로 설정하고, 계정을 사용하도록 설정하거나 현재 설정을 그대로 두는 값을 지정하지 않으려면 false로 설정합니다. |
|
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
표시 이름
|
DisplayName | string |
사서함의 표시 이름입니다. 주소 목록에 표시됩니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
주소 목록에서 숨김
|
HiddenFromAddressListsEnabled | boolean |
주소 목록에서 사서함을 숨기려면 true로, 사서함을 주소 목록에 표시하려면 false로 설정하거나 현재 설정을 그대로 두는 값을 지정하지 않습니다. |
|
|
사용자 지정 특성 1
|
CustomAttribute1 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 2
|
CustomAttribute2 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 3
|
CustomAttribute3 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 4
|
CustomAttribute4 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 5
|
CustomAttribute5 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 6
|
CustomAttribute6 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 7
|
CustomAttribute7 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 8
|
CustomAttribute8 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 9
|
CustomAttribute9 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 10
|
CustomAttribute10 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 11
|
CustomAttribute11 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 12
|
CustomAttribute12 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 13
|
CustomAttribute13 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 14
|
CustomAttribute14 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
사용자 지정 특성 15
|
CustomAttribute15 | string |
사용자 지정 특성 필드의 값입니다. 값을 지정하지 않으려면 비워 둡니다. 값을 비워 두려면(즉, 이미 값이 있고 다시 설정하려는 경우) '다시 설정' 작업을 사용합니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeSetMailboxResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange 사서함이 있나요?
지정된 Exchange 사서함이 있는지 여부를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 사서함을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 '필터 속성 이름'으로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
받는 사람 유형 세부 정보
|
RecipientTypeDetails | string |
검색할 사서함의 유형입니다. 이 필드를 비워 두면 모든 유형의 사서함이 검색에 포함됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함이 있음
|
MailboxExists | boolean |
Exchange 사서함이 있으면 True입니다. Exchange 사서함이 없으면 False입니다. |
Microsoft Exchange에 연결
microsoft Exchange 서버에 IA-Connect 연결합니다. 다른 Exchange 작업을 실행하기 전에 이 작업을 실행해야 합니다. 사용자 이름과 암호를 지정하면 모든 후속 Exchange 작업이 해당 계정으로 실행됩니다. 사용자 이름 및 암호를 지정하지 않으면 모든 후속 Exchange 작업은 IA-Connect 에이전트가 실행 중인 사용자 계정으로 실행됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 이름
|
Username | string |
Exchange PowerShell 명령을 실행할 때 사용할 계정의 사용자 이름입니다. 'DOMAIN\username' 형식(예: TESTDOMAIN\admin) 또는 'username@domainFQDN'(예: )로 사용자 이름을 지정할 수 있습니다 admin@testdomain.local. 사용자 이름 및 암호를 지정하지 않으면 모든 후속 Exchange 작업은 IA-Connect 에이전트가 실행 중인 사용자 계정으로 실행됩니다. |
|
|
암호
|
Password | password |
Exchange PowerShell 명령을 실행할 때 사용할 계정의 암호입니다. |
|
|
Exchange 서버 FQDN
|
ExchangeServerFQDN | True | string |
Microsoft Exchange 서버의 FQDN(정규화된 도메인 이름) 또는 호스트 이름입니다. |
|
SSL 사용
|
UseSSL | boolean |
HTTPS/SSL을 사용하여 Microsoft Exchange 서버에 연결하려는 경우 true로 설정합니다. 이렇게 하면 모든 트래픽이 암호화되지만 Exchange 서버가 SSL을 통해 PowerShell 명령을 수락하도록 설정되는 경우에만 작동합니다. |
|
|
연결 방법
|
ConnectionMethod | string |
Microsoft Exchange에 연결하는 데 사용해야 하는 메서드입니다. 'Local'은 원격 Exchange Runspace를 로컬로 가져오고 로컬로 명령을 실행합니다. 'Remote'는 원격 Exchange Runspace에서 직접 실행되며 보안 제한으로 인해 일반 PowerShell 스크립트를 실행하지 못할 수 있습니다. |
|
|
인증 메커니즘
|
AuthenticationMechanism | string |
원격 컴퓨터에 연결하거나 스크립트를 대체 사용자로 실행하는 경우 사용할 인증 메커니즘입니다. 지원되는 값은 'Basic', 'Credssp', 'Default', 'Digest', 'Kerberos' 및 'Negotiate'입니다. |
|
|
연결되지 않은 경우에만 연결
|
OnlyConnectIfNotAlreadyConnected | boolean |
false로 설정된 경우: IA-Connect 이미 연결된 경우에도 이 작업은 항상 Exchange에 연결됩니다. true(기본값):IA-Connect 동일한 설정으로 Exchange에 이미 연결되어 있고 Exchange 연결이 응답하는 경우 IA-Connect 연결이 이미 설정되어 있으므로 아무 작업도 수행하지 않습니다. |
|
|
로컬로 가져올 명령 유형
|
CommandTypesToImportLocally | string |
'로컬' 연결 메서드는 Exchange PowerShell 명령을 로컬로 가져옵니다. 이 옵션을 사용하면 가져올 PowerShell 명령을 선택할 수 있습니다. 이 목록을 최소한으로 유지하면 메모리 사용량과 연결 시간이 모두 줄어듭니다. 'All'(기본값: 이전 버전과의 호환성)은 모든 PS 명령을 가져옵니다. 'IA-Connect만'(권장 옵션)은 IA-Connect 사용하는 PS 명령만 가져옵니다(추가 PS 명령을 지정할 수 있습니다). 'Specified'는 지정한 PS 명령만 가져오며 지정하지 않은 PS 명령에 따라 일부 IA-Connect 작업이 중단될 수 있습니다. |
|
|
로컬로 가져올 추가 명령
|
AdditionalCommandsToImportLocallyCSV | string |
'Local' 연결 메서드를 사용하고 'IA-Connect만' 또는 '지정됨' PS 명령을 가져오도록 선택한 경우 가져올 추가 PS 명령의 쉼표로 구분된 목록을 지정할 수 있습니다. 예: 'Get-Mailbox,New-Mailbox,New-DistributionGroup'. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenExchangePowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Microsoft Exchange에 연결됨
IA-Connect Microsoft Exchange 서버에 연결되어 있는지 보고합니다. 'Microsoft Exchange에 연결' 작업을 사용하여 연결합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
통신 테스트
|
TestCommunications | boolean |
false로 설정된 경우: IA-Connect Exchange 서버 연결이 작동하고 마지막으로 알려진 상태를 사용하는지 확인하는 테스트 명령을 실행하지 않습니다. true(기본값)로 설정하면 IA-Connect 테스트 명령을 실행하여 Exchange 서버 연결이 작동하고 있는지 확인합니다. |
|
|
PowerShell Runspace 프로세스 ID 검색
|
RetrievePowerShellRunSpacePID | boolean |
true로 설정된 경우: IA-Connect 에이전트는 PowerShell Runspace를 호스팅하는 프로세스의 프로세스 ID에 대한 정보를 검색합니다. 이 정보는 'PowerShell Runspace 프로세스 ID' 및 'PowerShell Runspace를 호스트하는 에이전트인가요'의 출력에 제공됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Microsoft Exchange에 연결됨
|
ExchangeRunspaceOpen | boolean |
IA-Connect Microsoft Exchange에 연결된 경우 true로 설정합니다. |
|
Exchange 연결 방법
|
ExchangeConnectionMethod | string |
현재 Exchange 연결 방법(로컬 또는 원격)을 보유합니다. |
|
PowerShell Runspace 프로세스 ID
|
PowerShellRunspacePID | integer |
PowerShell RUNSPACE 프로세스 ID(PID)입니다. IA-Connect 에이전트가 PowerShell Runspace를 호스팅하는 경우 이 값은 IA-Connect 에이전트의 PID가 됩니다. PowerShell Runspace가 격리된 경우 이 값은 격리 프로세스의 PID가 됩니다. |
|
PowerShell Runspace를 호스트하는 에이전트인가요?
|
IsAgentHostingPowerShellRunSpace | boolean |
IA-Connect 에이전트가 PowerShell Runspace를 호스팅하는 경우(예: 'PowerShell Runspace 프로세스 ID'가 에이전트 PID인 경우) true를 반환합니다. |
Microsoft Exchange에서 연결 끊기
Microsoft Exchange 서버에서 IA-Connect 연결을 끊습니다('Microsoft Exchange에 연결' 작업을 사용하여 연결됨). 다시 연결할 때까지 Microsoft Exchange PowerShell 작업을 다시 실행할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
CloseExchangePowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Office 365 PowerShell 스크립트 실행
IA-Connect 에이전트가 실행되는 세션의 Office 365 Runspace에서 PowerShell 스크립트를 실행합니다. 여기서 스크립트 내용은 명령의 일부로 IA-Connect 에이전트에 전달됩니다. 사용자 지정 Office 365 Exchange Online PowerShell 코드를 실행하기 위한 권장 작업입니다. 이 작업은 에이전트 스레드로 실행된 PowerShell 스크립트의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
PowerShell 스크립트 내용
|
PowerShellScriptContents | string |
Office 365 Runspace에서 실행할 PowerShell 스크립트의 내용입니다. IA-Connect PowerShell 자동화 엔진에 직접 전달하여 이 스크립트 as-is 실행합니다. 실제로 디스크에 PowerShell 스크립트가 만들어지지 않습니다. 또는 return 및 'scriptpath'를 입력하여 디스크에서 기존 PowerShell 스크립트를 실행할 수 있습니다. 예: return & 'c:\scripts\O365TestScript.ps1'. |
|
|
결과가 없나요? 오류
|
IsNoResultAnError | boolean |
PowerShell 명령에서 반환되는 데이터가 없는 경우 오류가 발생하나요? |
|
|
복합 형식 반환
|
ReturnComplexTypes | boolean |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. '컬렉션으로 반환할 속성', 'serialize할 속성 이름' 및 '직렬화할 속성 형식'을 입력하면 반환해야 하는 '복합' 속성과 데이터 형식을 지정하는 데 사용되는 메서드를 지정할 수 있습니다(속성별로 가장 적합한 속성 선택). 이 입력을 사용하면 나머지 속성(즉, '복합'이고 명시적으로 이름이 지정되지 않은 속성)을 사용하여 수행해야 하는 작업을 지정할 수 있습니다. true로 설정하면 IA-Connect ToString()을 사용하여 데이터의 문자열 표현을 반환하려고 합니다. false(기본값)로 설정하면 IA-Connect 속성을 반환하지 않습니다. |
|
|
부울을 부울로 반환
|
ReturnBooleanAsBoolean | boolean |
부울 속성을 부울로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
숫자를 10진수로 반환
|
ReturnNumericAsDecimal | boolean |
숫자 속성을 숫자로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
날짜로 반환 날짜
|
ReturnDateAsDate | boolean |
Date 속성을 날짜로 반환해야 하나요? false이면 문자열로 반환됩니다. |
|
|
컬렉션으로 반환할 속성
|
PropertiesToReturnAsCollectionJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 컬렉션으로 반환해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있습니다. 속성, 해당 형식 및 값에 따라 대체 입력 '직렬화할 속성 이름' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 JSON 또는 CSV 형식으로 입력할 수 있습니다. 예를 들어 EmailAddresses 및 MemberOf 배열 속성을 반환하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
PowerShell 로컬 범위
|
LocalScope | boolean |
기본 Office 365 PowerShell 명령을 로컬 범위에서 실행해야 합니다. 기본적으로 이 설정은 설정되지 않으므로 PowerShell은 기본값으로 돌아갑니다. |
|
|
스크립트를 스레드로 실행
|
RunScriptAsThread | boolean |
false(기본값)로 설정하면 IA-Connect 에이전트는 PowerShell 스크립트를 즉시 실행하고 스크립트가 완료되면 디렉터에게 결과를 반환합니다. 오래되거나 복잡한 PowerShell 스크립트를 실행하는 경우 이 작업은 시간이 초과할 수 있습니다. true로 설정하면 IA-Connect 에이전트가 PowerShell 스크립트를 에이전트 스레드로 실행하고 IA-Connect 디렉터(또는 Orchestrator, PowerShell 모듈, Blue Prism)가 이 에이전트 스레드의 상태를 모니터링하여 완료될 때까지 대기할 수 있습니다. 이렇게 하면 긴 또는 복잡한 PowerShell 스크립트를 시간 제한 없이 실행할 수 있습니다. IA-Connect 에이전트 9.3 이하에서는 PowerShell 스크립트를 에이전트 스레드로 실행할 수 없습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 PowerShell 스크립트를 에이전트 스레드로 실행하고 '스레드를 기다리는 초'를 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. PowerShell 스크립트를 실행하기만 하면 0(기본값)으로 설정됩니다(따라서 에이전트 스레드로 실행되는 이전 PowerShell 스크립트의 결과를 검색하지 않음). |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 스크립트 실행'이 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 현재 PowerShell 스크립트를 실행하는 에이전트 스레드가 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 계속해서 PowerShell 스크립트를 실행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 에이전트 스레드가 완료되기를 기다리는 '에이전트 스레드가 성공적으로 완료되기를 기다립니다' 작업을 사용하여 나중에 스크립트 결과를 검색한 다음 에이전트 스레드 ID로 설정된 입력 '스레드 ID에 대한 출력 데이터 검색'을 사용하여 이 'PowerShell 스크립트 실행' 작업을 다시 실행할 수 있습니다. |
|
|
스크립트에 저장된 암호가 포함되어 있습니다.
|
ScriptContainsStoredPassword | boolean |
스크립트에 {IAConnectPassword:StoredPasswordIdentifier} 형식의 IA-Connect 저장된 암호 식별자 또는 {OrchestratorCredential:FriendlyName} 형식의 IA-Connect Orchestrator 제네릭 자격 증명이 포함된 경우 true로 설정합니다. { } 구는 지정된 암호로 대체되고 이스케이프되어 작은따옴표로 배치됩니다(스크립트에 이미 따옴표가 없는 경우). |
|
|
자세한 정보 출력 기록
|
LogVerboseOutput | boolean |
powerShell 자세한 정보 출력을 IA-Connect 로그에 기록하려면 true로 설정합니다. 디버깅에 유용할 수 있습니다. 스크립트에서 자세한 내용을 기록하려면 '내 메시지' -자세한 정보 표시를 Write-Verbose PowerShell을 사용합니다. |
|
|
serialize할 속성 이름
|
PropertyNamesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 serialize해야 하는 '복합' 속성(이름별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 형식'(하나를 선택)을 사용하는 것도 고려해야 합니다. 예를 들어 EmailAddresses 및 MemberOf 속성을 직렬화하려면 [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}](JSON 테이블 형식), ["EmailAddresses", "MemberOf"](JSON 배열 형식) 또는 EmailAddresses,MemberOf(CSV 형식)를 입력합니다. |
|
|
직렬화할 속성 형식
|
PropertyTypesToSerializeJSON | string |
PowerShell 반환 데이터에 '복합' 속성(예: 값, 배열, 테이블 또는 클래스 컬렉션)이 포함된 경우 이러한 속성은 기본적으로 IA-Connect PowerShell 응답에서 반환되지 않습니다. 이 옵션을 사용하면 JSON으로 직렬화해야 하는 '복합' 속성(형식별) IA-Connect 지정할 수 있으므로 문자열 형식으로 반환됩니다(받은 후 역직렬화할 수 있습니다). 속성, 해당 형식 및 값에 따라 대체 입력 '컬렉션으로 반환할 속성' 및 '직렬화할 속성 이름'(하나를 선택)을 사용하는 것도 고려해야 합니다. 이 입력은 단일 'PropertyType' 필드가 있는 컬렉션입니다. 예: Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]형식의 속성을 직렬화하려면 [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}]를 입력합니다(JSON 테이블 형식), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"](JSON 배열 형식) 또는 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[](CSV 형식). |
|
|
이름
|
Name | string |
입력 PowerShell 매개 변수의 이름입니다. PowerShell 변수 명명 형식을 충족해야 합니다(즉, 공백 또는 특수 기호를 사용하지 않는 것이 좋습니다). PowerShell 변수 이름은 대/소문자를 구분하지 않습니다. 예를 들어 MyVariable은 변수 $MyVariable 생성됩니다. |
|
|
문자열 값
|
StringValue | string |
입력 PowerShell 매개 변수에 할당할 문자열 값입니다. 또는 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
정수 값
|
IntValue | integer |
입력 PowerShell 매개 변수에 할당할 정수(정수) 값입니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
부울 값
|
BooleanValue | boolean |
입력 PowerShell 매개 변수에 할당할 부울(true 또는 false) 값입니다. 또는 문자열 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
십진수 값
|
DecimalValue | double |
입력 PowerShell 매개 변수에 할당할 10진수 값입니다. 또는 문자열, 부울 또는 정수 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
개체 값
|
ObjectValue | object |
입력 PowerShell 매개 변수에 할당할 개체 값입니다. PowerShell 스크립트에서 JSON 직렬화된 문자열 변수가 되므로 ConvertFrom-Json을 사용하여 개체로 역직렬화합니다. 또는 문자열, 부울 또는 숫자 값을 입력하는 경우 다른 값 입력을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
PowerShell 출력 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
스레드 ID
|
ThreadId | integer |
PowerShell 스크립트를 에이전트 스레드로 실행하는 경우 이 출력에는 PowerShell 스크립트 실행을 모니터링하고 스크립트가 완료될 때 PowerShell 스크립트 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
Office 365 공유 사서함 및 사용자 계정 만들기
Microsoft Exchange Online에서 공유 사서함을 만들고 Azure Active Directory/Entra ID에서 사용자 계정을 만듭니다. 사용자가 Azure Active Directory/Entra ID에 아직 없는 경우에만 이 작업을 사용합니다. 공유 사서함 SMTP 주소는 이름, 별칭 또는 기본 SMTP 주소(제공된 입력에 따라 다름)를 기반으로 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름
|
Name | True | string |
사서함의 고유한 이름입니다. 별칭 또는 기본 SMTP 주소를 설정하지 않는 한 외부에 표시되지 않는 내부 값이며, 이 경우 사서함 SMTP 전자 메일 주소의 이름 구성 요소로 사용됩니다. 대체 프로시저나 다른 값을 사용해야 하는 이유가 없다면 별칭과 동일한 값으로 설정하는 것이 좋습니다. |
|
이름 (이름의 첫 부분)
|
FirstName | string |
사서함 사용자의 이름입니다. |
|
|
성(姓)
|
LastName | string |
사서함 사용자의 성/성입니다. |
|
|
이니셜
|
Initials | string |
사서함 사용자의 중간 이니셜입니다. |
|
|
표시 이름
|
DisplayName | string |
선택적 사서함 표시 이름입니다. |
|
|
Alias
|
Alias | string |
사용자의 사서함 별칭(메일 애칭이라고도 함)입니다. 이 값은 사서함 SMTP 전자 메일 주소의 이름 구성 요소를 생성하는 데 사용됩니다(예: '별칭'의 별칭이 발생 alias@mydomain.com함). 기본 SMTP 주소와 다른 경우 사서함에 여러 SMTP 주소가 있습니다. 이 값을 제공하지 않으면 사서함 별칭이 설정되지 않으며 사서함에는 기본 SMTP 주소만 있습니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 SMTP 전자 메일 주소입니다. 사서함 별칭과 다른 경우 사서함에 여러 SMTP 주소가 있습니다. 이 값을 제공하지 않으면 기본 SMTP 주소는 별칭 또는 이름 및 조직 정책(일반적으로 Office 365 관리 센터에서 설정된 기본 도메인을 기반으로)에 따라 자동으로 계산됩니다. |
|
|
보관 사서함 만들기
|
Archive | boolean |
Microsoft Exchange Online 또는 Office 365에서 보관 사서함을 추가로 만들려면 true로 설정합니다. |
|
|
사서함 지역
|
MailboxRegion | string |
다중 지역 환경에서 사서함을 만들 선택적 지역입니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
새 사서함 작업의 출력(JSON 형식)입니다. |
|
새 사용자 Microsoft Online 서비스 ID
|
NewUserMicrosoftOnlineServicesID | string |
새로 만든 사서함 사용자 계정의 Microsoft Online 서비스 ID입니다. 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 GUID
|
NewMailboxGUID | string |
새로 만든 사서함의 GUID입니다. 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 기본 SMTP 주소
|
NewMailboxPrimarySmtpAddress | string |
새로 만든 사서함의 기본 SMTP 주소입니다. |
Office 365 메일 그룹 가져오기
지정한 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹의 속성을 반환합니다. ID 또는 필터를 사용하여 검색할 수 있습니다. ID 검색은 0개 또는 1개 결과를 반환해야 합니다. 필터 검색은 0개 이상의 결과를 반환할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | string |
메일 그룹 또는 메일 사용 보안 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 메일 그룹을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 DisplayName, Name, GroupType, PrimarySMTPAddress입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
메일 그룹을 찾을 수 없는 경우 예외를 발생하려면 true로 설정합니다. 메일 그룹을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
JSON으로 형식이 지정된 PowerShell 스크립트의 출력입니다. |
|
찾은 그룹 수
|
CountOfGroupsFound | integer |
검색 ID와 일치하는 메일 그룹 또는 메일 사용 보안 그룹의 수입니다. 일반적으로 1. |
Office 365 메일 그룹 구성원 가져오기
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹의 구성원 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
GroupIdentity | True | string |
검색할 메일 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
검색할 속성
|
PropertiesToRetrieveJSON | string |
JSON 또는 CSV 형식으로 검색할 멤버 속성 목록입니다. 예: ["Identity", "DistinguishedName"](JSON 배열 형식) 또는 "Identity","DistinguishedName"(CSV 형식). 일반적인 멤버 속성에는 별칭, DisplayName, DistinguishedName, Identity, Name, PrimarySMTPAddress, RecipientType 및 SamAccountName이 포함됩니다. 이 필드를 비워 두면 기본 속성 집합이 검색됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메일 그룹 구성원
|
O365DistributionGroupMembersJSON | string |
JSON 형식의 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹의 구성원 목록입니다. |
|
메일 그룹 멤버 수
|
O365CountOfDistributionGroupsMembers | integer |
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹의 구성원 수입니다. |
Office 365 메일 그룹 제거
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 가능 보안 그룹을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | True | string |
제거할 메일 그룹 또는 메일 사용 보안 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
보안 그룹 관리자 검사 무시
|
BypassSecurityGroupManagerCheck | boolean |
IA-Connect 에이전트 자동화 계정이 메일 그룹 또는 메일 사용 보안 그룹의 소유자가 아닌 경우 그룹을 제거할 수 없습니다. 이 옵션을 true(기본값)로 설정하면 소유자 확인이 무시되지만 자동화 계정이 Exchange '조직 관리' 역할 그룹에 있거나 '역할 관리' 역할이 할당되어야 합니다. 이는 수정해야 하는 모든 그룹의 소유자가 아닌 Office 355 Exchange Online 그룹을 수정할 수 있는 권한을 부여하는 단일 역할입니다. |
|
|
그룹이 없는 경우 예외
|
ErrorIfGroupDoesNotExist | boolean |
그룹이 없는 경우 예외가 발생해야 하나요? 그룹이 없는 경우 아무 작업도 수행하지 않도록 false로 설정합니다(예: 이미 삭제되었을 수 있음). 존재하지 않는 그룹이 오류(예: 존재할 것으로 예상됨)인 경우 true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365RemoveDistributionGroupResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Office 365 사서함 가져오기
지정한 Microsoft Exchange Online 또는 Office 365 사서함의 속성을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
|
필터 속성 이름
|
FilterPropertyName | string |
ID로 검색하는 대신 사서함을 필터링할 속성의 이름을 제공합니다. 일반적인 속성 이름은 Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName입니다. 필터를 사용하는 경우 '필터 속성 비교' 및 '필터 속성 값' 필드도 채워야 합니다. |
|
|
필터 속성 비교
|
FilterPropertyComparison | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 비교 유형을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 비교는 '같음' 또는 '좋아요'일 수 있음). 원시 필터(OPATH 형식)를 입력하려면 '원시: 필터를 수동으로 입력'의 비교 유형을 선택하고 '필터 속성 값' 필드에 전체 필터를 입력합니다. |
|
|
필터 속성 값
|
FilterPropertyValue | string |
ID로 검색하는 대신 필터로 검색하는 경우 여기에 필터 속성 값을 입력합니다(예: 필터 속성 이름이 '별칭'인 경우 필터 속성 값은 'JohnDoe'일 수 있음). |
|
|
받는 사람 유형 세부 정보
|
RecipientTypeDetails | string |
검색할 사서함의 유형입니다. 이 필드를 비워 두면 모든 유형의 사서함이 검색에 포함됩니다. |
|
|
결과가 예외가 아닙니다.
|
NoResultIsAnException | boolean |
사서함이 없는 경우 예외를 발생하려면 true로 설정합니다. 사서함을 찾을 수 없는 경우 0의 수를 보고하도록 false로 설정합니다. 영어 이외의 언어로 ID와 함께 사용할 때는 'false' 옵션이 작동하지 않을 수 있으므로 필터를 사용하여 검색하는 것이 좋습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
검색 ID와 일치하는 사서함(및 해당 속성) 목록(JSON 형식)입니다. |
|
찾은 사서함 수
|
CountOfMailboxesFound | integer |
검색 ID와 일치하는 사서함의 수입니다. 일반적으로 1. |
Office 365 사서함 대기
지정된 Microsoft Exchange Online 또는 Office 365 사서함이 존재할 때까지 기다립니다. 이는 AD 동기화 또는 라이선스 설정이 적용되기를 기다리는 경우에 일반적입니다. 사서함이 이미 있는 경우 작업은 즉시 성공적으로 반환됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
받는 사람 유형 세부 정보
|
RecipientTypeDetails | string |
검색할 사서함의 유형입니다. 이 필드를 비워 두면 모든 유형의 사서함이 검색에 포함됩니다. |
|
|
확인할 횟수
|
NumberOfTimesToCheck | True | integer |
사서함이 있는지 확인할 횟수입니다. 각 검사는 구성 가능한 시간으로 구분됩니다. |
|
시도 간격(초)
|
SecondsBetweenTries | True | integer |
각 검사 사이에 대기할 시간(초)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
대기한 후 이미 존재했거나 존재했던 경우 JSON 형식으로 배치된 사서함의 속성입니다. |
|
찾은 사서함 수
|
CountOfMailboxesFound | integer |
검색 ID와 일치하는 사서함의 수입니다. 1은 성공적인 대기(또는 사서함이 이미 있음)를 나타냅니다. 0은 대기한 후에도 기존 사서함이 아님을 나타냅니다. |
Office 365 사서함 메일 그룹 멤버 자격 검색
Office 365 또는 Exchange Online 사서함이 구성원인 메일 그룹 또는 메일 사용 가능 보안 그룹을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
MailboxIdentity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
검색할 속성
|
PropertiesToRetrieveJSON | string |
JSON 또는 CSV 형식으로 검색할 멤버 속성 목록입니다. 예: ["Identity", "DistinguishedName"](JSON 배열 형식) 또는 "Identity","DistinguishedName"(CSV 형식). 일반적인 그룹 속성에는 별칭, DisplayName, DistinguishedName, GroupType, Identity, Name, PrimarySmtpAddress 및 SamAcountName이 포함됩니다. 이 필드를 비워 두면 기본 속성 집합이 검색됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 결과 JSON
|
PowerShellJSONOutput | string |
사서함이 구성원인 Office 365 또는 Exchange Online 메일 그룹 또는 메일 사용 가능 보안 그룹의 목록(JSON 형식)입니다. |
|
찾은 메일 그룹 수
|
CountOfDistributionGroupsFound | integer |
사서함이 구성원인 Office 365 또는 Exchange Online 메일 그룹 또는 메일 사용 가능 보안 그룹의 수입니다. |
Office 365 사서함 및 사용자 계정 만들기
Microsoft Exchange Online에서 사서함을 만들고 Azure Active Directory/Entra ID에서 사용자 계정을 만듭니다. 사용자가 Azure Active Directory/Entra ID에 아직 없는 경우에만 이 작업을 사용합니다. 사용자가 이미 있는 경우 사용자 계정에 적절한 라이선스를 할당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Microsoft Online 서비스 ID
|
MicrosoftOnlineServicesID | True | string |
사용자의 고유 ID입니다. 이 형식은 일반적으로 ''name@xxx.onmicrosoft.com입니다. |
|
이름
|
Name | True | string |
사서함의 고유한 이름입니다. 외부에 표시되지 않는 내부 값입니다. 대체 프로시저나 다른 값을 사용해야 하는 이유가 없는 한 Microsoft Online 서비스 ID의 이름 구성 요소(예: 'user1')와 동일한 값으로 설정하는 것이 좋습니다. |
|
이름 (이름의 첫 부분)
|
FirstName | string |
사용자의 이름입니다. |
|
|
성(姓)
|
LastName | string |
사용자의 성/성입니다. |
|
|
이니셜
|
Initials | string |
사용자의 중간 이니셜입니다. |
|
|
표시 이름
|
DisplayName | string |
선택적 사용자 표시 이름입니다. |
|
|
Alias
|
Alias | string |
사용자의 사서함 별칭(메일 애칭이라고도 함)입니다. 이 값은 사용자의 SMTP 전자 메일 주소의 이름 구성 요소를 생성하는 데 사용됩니다(예: '별칭'의 별칭이 발생 alias@mydomain.com). 이 주소가 기본 SMTP 주소와 다른 경우 사용자에게 여러 SMTP 주소가 있습니다. 이 값을 제공하지 않으면 사용자 별칭이 설정되지 않으며 사용자에게는 기본 SMTP 주소만 있습니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 SMTP 전자 메일 주소입니다. 사용자 별칭과 다른 경우 사용자가 여러 SMTP 주소를 가지게 됩니다. 이 값을 제공하지 않으면 기본 SMTP 주소는 조직 정책에 따라 자동으로 계산됩니다(일반적으로 Office 365 관리 센터에서 설정된 기본 도메인을 기반으로 합니다). |
|
|
계정 암호
|
Password | password |
사용자 암호입니다. 이를 지정하고 Azure Active Directory 암호 복잡성 규칙을 충족해야 합니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. |
|
|
계정 암호가 저장된 암호
|
AccountPasswordIsStoredPassword | boolean |
암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다. |
|
|
다음 로그온할 때 반드시 암호 변경
|
ResetPasswordOnNextLogon | boolean |
사용자가 로그인할 때 암호를 변경하도록 강제하려면 true로 설정합니다(즉, 여기에 설정된 새 암호는 사용자가 로그인하도록 일회성 암호임). 사용자가 수동으로 변경할 때까지 사용할 암호인 경우 false로 설정합니다. |
|
|
보관 사서함 만들기
|
Archive | boolean |
Microsoft Exchange Online 또는 Office 365에서 보관 사서함을 추가로 만들려면 true로 설정합니다. |
|
|
사서함 계획
|
MailboxPlan | string |
사서함에 적용할 선택적 사서함 계획입니다. 사서함 계획은 사서함에서 사용할 수 있는 사용 권한 및 기능을 지정합니다. IA-Connect Inspector의 'Office 365' PowerShell Runspace에서 'Get-MailboxPlan' 스크립트를 실행하여 사용 가능한 사서함 계획을 볼 수 있습니다. |
|
|
사서함 지역
|
MailboxRegion | string |
다중 지역 환경에서 사서함을 만들 선택적 지역입니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
새 사서함 작업의 출력(JSON 형식)입니다. |
|
새 사용자 Microsoft Online 서비스 ID
|
NewUserMicrosoftOnlineServicesID | string |
새로 만든 사용자 계정의 Microsoft Online 서비스 ID입니다. 이는 추가 작업에 사용할 수 있는 사용자의 고유 식별자입니다. |
|
새 사서함 GUID
|
NewMailboxGUID | string |
새로 만든 사서함의 GUID입니다. 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 기본 SMTP 주소
|
NewMailboxPrimarySmtpAddress | string |
새로 만든 사서함의 기본 SMTP 주소입니다. |
Office 365 사서함에 대한 자동 회신(부재 중) 설정
Microsoft Exchange Online 또는 Office 365 사서함에 대한 자동 회신(부재 중)을 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
자동 회신 상태
|
AutoReplyState | True | string |
자동 회신을 사용하거나 사용하지 않도록 설정할 수 있습니다. |
|
내부 메시지
|
InternalMessage | string |
내부 보낸 사람에게 보낼 자동 회신(부재 중) 메시지입니다. 메시지를 제거하려면 공백으로 설정합니다. |
|
|
외부 대상 그룹
|
ExternalAudience | string |
자동 회신을 외부 대상 그룹에 보낼지 여부를 지정할 수 있습니다. 기본적으로 회신은 모든 외부 보낸 사람에게 전송됩니다. |
|
|
외부 메시지
|
ExternalMessage | string |
외부 대상 그룹을 '모두' 또는 '알려진'으로 설정한 경우 외부 보낸 사람에게 보낼 자동 회신(부재 중) 메시지입니다. 메시지를 제거하려면 공백으로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365SetO365MailboxAutoReplyConfigurationResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Office 365 사서함에 보관 파일이 있나요?
Microsoft Exchange Online의 기존 사서함에 보관 사서함이 있는지 여부를 보고합니다. 사서함이 없으면 예외가 발생합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사서함에 보관함
|
MailboxHasAnArchive | boolean |
사서함에 보관이 있는 경우 true로 설정합니다. |
Office 365 사서함의 속성 설정
Microsoft Exchange Online 또는 Office 365 사서함에서 속성을 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
계정 사용 안 함
|
AccountDisabled | boolean |
계정을 사용하지 않도록 설정하려면 true로 설정하고, 계정을 사용하도록 설정하거나 현재 설정을 그대로 두는 값을 지정하지 않으려면 false로 설정합니다. |
|
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. |
|
|
표시 이름
|
DisplayName | string |
사서함의 표시 이름입니다. 주소 목록에 표시됩니다. |
|
|
주소 목록에서 숨김
|
HiddenFromAddressListsEnabled | boolean |
주소 목록에서 사서함을 숨기려면 true로, 사서함을 주소 목록에 표시하려면 false로 설정하거나 현재 설정을 그대로 두는 값을 지정하지 않습니다. |
|
|
사용자 지정 특성 1
|
CustomAttribute1 | string |
사용자 지정 특성 1 필드의 값입니다. |
|
|
사용자 지정 특성 2
|
CustomAttribute2 | string |
사용자 지정 특성 2 필드의 값입니다. |
|
|
사용자 지정 특성 3
|
CustomAttribute3 | string |
사용자 지정 특성 3 필드의 값입니다. |
|
|
사용자 지정 특성 4
|
CustomAttribute4 | string |
사용자 지정 특성 4 필드의 값입니다. |
|
|
사서함 유형
|
Type | string |
사서함의 유형입니다. 현재 값을 변경하지 않으려면 비워 둡니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365SetO365MailboxResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
Office 365에 연결됨
IA-Connect Office 365 PowerShell 모듈을 사용하여 Office 365에 연결되어 있는지 보고합니다. 'Office 365에 연결' 작업을 사용하여 연결합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
통신 테스트
|
TestCommunications | boolean |
false로 설정된 경우: IA-Connect Office 365 Exchange Online 연결이 작동하고 마지막으로 알려진 상태를 사용하는지 확인하는 테스트 명령을 실행하지 않습니다. true(기본값)로 설정하면 IA-Connect 테스트 명령을 실행하여 Office 365 Exchange Online 연결이 작동하고 있는지 확인합니다. |
|
|
PowerShell Runspace 프로세스 ID 검색
|
RetrievePowerShellRunSpacePID | boolean |
true로 설정된 경우: IA-Connect 에이전트는 PowerShell Runspace를 호스팅하는 프로세스의 프로세스 ID에 대한 정보를 검색합니다. 이 정보는 'PowerShell Runspace 프로세스 ID' 및 'PowerShell Runspace를 호스트하는 에이전트인가요'의 출력에 제공됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Office 365에 연결됨
|
O365RunspaceOpen | boolean |
office 365 PowerShell 모듈을 사용하여 IA-Connect Office 365에 연결된 경우 true로 설정합니다. |
|
Office 365 연결 방법
|
Office365ConnectionMethod | string |
현재 Office 365 연결 방법 EXOV1 또는 EXOV2를 보유합니다. |
|
PowerShell Runspace 프로세스 ID
|
PowerShellRunspacePID | integer |
PowerShell RUNSPACE 프로세스 ID(PID)입니다. IA-Connect 에이전트가 PowerShell Runspace를 호스팅하는 경우 이 값은 IA-Connect 에이전트의 PID가 됩니다. PowerShell Runspace가 격리된 경우 이 값은 격리 프로세스의 PID가 됩니다. |
|
PowerShell Runspace를 호스트하는 에이전트인가요?
|
IsAgentHostingPowerShellRunSpace | boolean |
IA-Connect 에이전트가 PowerShell Runspace를 호스팅하는 경우(예: 'PowerShell Runspace 프로세스 ID'가 에이전트 PID인 경우) true를 반환합니다. |
Office 365에서 연결 끊기
Office 365 PowerShell 모듈을 사용하여 Office 365에서 IA-Connect 연결을 끊습니다('Office 365에 연결' 작업을 사용하여 연결됨). 다시 연결할 때까지 Office 365 PowerShell 작업을 다시 실행할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
CloseO365PowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
관리자 역할 할당에서 Azure AD 사용자 제거
기존 Azure Active Directory 관리자 역할 할당에서 Azure Active Directory 사용자(또는 다른 개체)를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
역할 개체 ID 또는 표시 이름
|
RoleObjectId | True | string |
Azure Active Directory 관리자 역할의 ID 또는 표시 이름입니다. 표시 이름(예: "애플리케이션 개발자") 또는 ObjectId(예: UUID/GUID 값)로 AAD 관리자 역할을 지정할 수 있습니다. |
|
디렉터리 범위 ID
|
DirectoryScopeId | string |
제거에 지정된 역할 할당이 일치해야 하는 선택적 디렉터리 범위 ID입니다. 예: /는 전체 테넌트를 나타내며 디렉터리 범위 ID가 제거되는 명명된 역할 할당만 발생합니다. /GUID는 앱 등록을 나타내고 /administrativeUnits/GUID는 관리 단위를 나타냅니다. 디렉터리 범위에 관계없이 역할 할당을 제거하려면 * 또는 빈 값을 지정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
역할에서 제거된 사용자
|
UserRemovedFromRole | boolean |
사용자가 역할에서 제거된 경우 True입니다. 사용자가 역할에 할당되지 않은 경우 False입니다(따라서 수행할 작업이 없음). |
관리자 역할에 Azure AD 사용자 할당
기존 Azure Active Directory 관리자 역할에 Azure Active Directory 사용자(또는 다른 개체)를 할당합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
역할 개체 ID 또는 표시 이름
|
RoleObjectId | True | string |
Azure Active Directory 관리자 역할의 ID 또는 표시 이름입니다. 표시 이름(예: "애플리케이션 개발자") 또는 ObjectId(예: UUID/GUID 값)로 AAD 관리자 역할을 지정할 수 있습니다. |
|
디렉터리 범위 ID
|
DirectoryScopeId | string |
역할 할당의 디렉터리 범위 ID입니다. 예: / 전체 테넌트를 나타내고 /GUID는 앱 등록을 나타내고 /administrativeUnits/GUID는 관리 단위를 나타냅니다. |
|
|
먼저 사용자 역할 멤버 자격 확인
|
CheckUserRoleMembershipsFirst | boolean |
true(기본값)로 설정하면 IA-Connect 역할에 할당하기 전에 사용자의 역할 할당을 확인합니다. 사용자가 역할에 이미 할당된 경우 IA-Connect 아무 작업도 수행하지 않고도 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 즉시 사용자를 역할에 할당하므로 사용자가 역할에 이미 할당된 경우 오류가 발생합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2AssignUserToRoleResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
그룹에 Azure AD 사용자 추가
기존 Azure Active Directory 보안 또는 M365 그룹에 Azure Active Directory 사용자를 추가합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
그룹 개체 ID 또는 표시 이름
|
GroupObjectId | True | string |
Azure Active Directory 그룹의 ID 또는 표시 이름입니다. 표시 이름(예: "재무 사용자") 또는 ObjectId(예: UUID/GUID 값)로 그룹을 지정할 수 있습니다. |
|
먼저 사용자 그룹 멤버 자격 확인
|
CheckUserGroupMembershipsFirst | boolean |
true로 설정하면 IA-Connect 그룹에 추가하기 전에 사용자의 그룹 멤버 자격을 확인합니다. 사용자가 이미 그룹의 구성원인 경우 IA-Connect 아무 작업도 수행하지 않고도 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 즉시 사용자를 그룹에 추가하므로 사용자가 이미 그룹에 있는 경우 오류가 발생합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2AddUserToGroupResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
그룹에서 Azure AD 사용자 제거
Azure Active Directory 그룹에서 Azure Active Directory 사용자를 제거합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
그룹 개체 ID 또는 표시 이름
|
GroupObjectId | True | string |
Azure Active Directory 그룹의 ID 또는 표시 이름입니다. 표시 이름(예: "재무 사용자") 또는 ObjectId(예: UUID/GUID 값)로 그룹을 지정할 수 있습니다. |
|
먼저 사용자 그룹 멤버 자격 확인
|
CheckUserGroupMembershipsFirst | boolean |
true로 설정하면 IA-Connect 그룹에서 제거를 시도하기 전에 사용자의 그룹 멤버 자격을 확인합니다. 사용자가 그룹의 구성원이 아닌 경우 IA-Connect 아무 작업도 수행하지 않고도 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 그룹에서 사용자를 즉시 제거하므로 사용자가 그룹에 없는 경우 오류가 발생합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2RemoveUserFromGroupResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
기본 Active Directory 도메인에 연결
IA-Connect 에이전트가 실행 중인 계정(즉, 기본 동작)을 사용하여 IA-Connect 에이전트를 실행하는 컴퓨터가 구성원인 도메인에 IA-Connect 에이전트를 연결합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenLocalPassthroughActiveDirectoryPowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
기존 사용자에 대한 Office 365 보관 사서함 만들기
Azure Active Directory/Entra ID의 기존 사용자에 대해 Microsoft Exchange Online에 보관된 사서함을 만듭니다. 사용자에게 사서함 및 적절한 라이선스가 이미 있어야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
보관이 있는지 확인
|
CheckIfArchiveExists | boolean |
true(기본값)로 설정하면 IA-Connect 에이전트가 사서함에 이미 보관이 있는지 확인합니다. 보관 파일이 이미 있는 경우 아무 작업도 수행할 수 없으며(보관 파일을 두 번 만들 수 없으므로) 에이전트가 성공을 반환합니다. false로 설정하면 IA-Connect 에이전트는 사서함에 이미 보관 파일이 있는지 확인하지 않으므로 이미 있는 경우 예외가 발생합니다. |
|
|
보관 이름
|
ArchiveName | string |
선택적 보관 이름입니다. 지정하지 않으면 기본값은 'In-Place 보관 - {표시 이름}'입니다. |
|
|
자동 확장 보관
|
AutoExpandingArchive | boolean |
true로 설정하면 스토리지 한도에 가까워지면 추가 스토리지 공간이 보관 사서함에 자동으로 추가됩니다. 이 기능은 사용하지 않도록 설정할 수 없으며, 사용하도록 설정한 후에는 사용할 수 없습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365EnableArchiveMailboxResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
를 대신하여 Exchange 사서함 보내기 설정
이 기존 사서함을 대신하여 보낼 수 있는 사용자를 지정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
대신 보내기 권한 부여
|
GrantSendOnBehalfTo | True | string |
이 사서함을 대신하여 전자 메일을 보낼 수 있는 사용자, 그룹 또는 사서함의 식별입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사용자를 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeSetMailboxSendOnBehalfOfPermissionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
메일 그룹에 Microsoft Exchange 멤버 추가
Exchange 메일 그룹에 멤버(예: 사용자)를 추가합니다. 멤버가 이미 그룹에 있는 경우 아무 작업도 수행되지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | True | string |
추가할 메일 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
추가할 멤버
|
Member | True | string |
메일 그룹에 추가할 멤버의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeAddDistributionGroupMemberResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
메일 그룹에 Office 365 구성원 추가
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹에 구성원을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | True | string |
추가할 메일 그룹 또는 메일 사용 보안 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
추가할 멤버
|
Member | True | string |
메일 그룹 또는 메일 사용 보안 그룹에 추가할 멤버의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
보안 그룹 관리자 검사 무시
|
BypassSecurityGroupManagerCheck | boolean |
IA-Connect 에이전트 자동화 계정이 메일 그룹 또는 메일 사용 보안 그룹의 소유자가 아닌 경우 그룹을 제거할 수 없습니다. 이 옵션을 true로 설정하면 소유자 확인이 무시되지만 자동화 계정이 Exchange '조직 관리' 역할 그룹에 있거나 '역할 관리' 역할이 할당되어야 합니다. 이는 수정해야 하는 모든 그룹의 소유자가 아닌 Office 355 Exchange Online 그룹을 수정할 수 있는 권한을 부여하는 단일 역할입니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365AddDistributionGroupMemberResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
메일 그룹에서 Microsoft Exchange 멤버 제거
Exchange 메일 그룹에서 멤버(예: 사용자)를 제거합니다. 멤버가 그룹에 없는 경우 아무 작업도 수행되지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
Identity | True | string |
추가할 메일 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
제거할 멤버
|
Member | True | string |
메일 그룹에서 제거할 멤버의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
보안 그룹 관리자 검사 무시
|
BypassSecurityGroupManagerCheck | boolean |
기본적으로 IA-Connect 에이전트 자동화 계정이 메일 그룹의 소유자가 아닌 경우 메일 그룹을 수정할 수 없습니다. 또는 이 옵션을 true로 설정하면 해당 검사가 제거되지만 자동화 계정이 Exchange '조직 관리' 역할 그룹에 있거나 '역할 관리' 역할이 할당되어야 합니다. 이는 수정해야 하는 모든 메일 그룹의 소유자가 아닌 Exchange 메일 그룹을 수정할 수 있는 권한을 부여하는 단일 역할입니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeRemoveDistributionGroupMemberResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
메일 그룹에서 Office 365 구성원 제거
Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 보안 그룹에서 구성원을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 그룹 ID
|
GroupIdentity | True | string |
제거할 메일 그룹 또는 메일 사용 보안 그룹의 ID입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 메일 그룹을 지정할 수 있습니다. |
|
제거할 멤버
|
Member | True | string |
메일 그룹 또는 메일 사용 보안 그룹에서 제거할 멤버의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
보안 그룹 관리자 검사 무시
|
BypassSecurityGroupManagerCheck | boolean |
IA-Connect 에이전트 자동화 계정이 메일 그룹 또는 메일 사용 보안 그룹의 소유자가 아닌 경우 그룹에서 구성원을 제거할 수 없습니다. 이 옵션을 true(기본값)로 설정하면 소유자 확인이 무시되지만 자동화 계정이 Exchange '조직 관리' 역할 그룹에 있거나 '역할 관리' 역할이 할당되어야 합니다. 이는 수정해야 하는 모든 그룹의 소유자가 아닌 Office 355 Exchange Online 그룹을 수정할 수 있는 권한을 부여하는 단일 역할입니다. |
|
|
멤버가 그룹에 없는 경우 예외
|
ExceptionIfMemberNotInGroup | boolean |
멤버가 그룹에 없는 경우 예외가 발생해야 하나요? 멤버가 그룹에 없는 경우(예: 이미 제거되었거나 그룹에 없는 경우) 아무 작업도 수행하지 않도록 false(기본값)로 설정합니다. 그룹에 없는 멤버가 오류인 경우(즉, 그룹에 있을 것으로 예상됨) true로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365RemoveDistributionGroupMemberResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
모든 Azure AD 사용자 라이선스 제거
사용자에게 할당된 모든 Azure AD SKU(사용자 라이선스)를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
ObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
AzureADv2RemoveAllAzureADUserLicenseResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
모든 관리자 역할 할당에서 Azure AD 사용자 제거
할당된 모든 Azure Active Directory 관리자 역할에서 Azure Active Directory 사용자(또는 다른 개체)를 제거합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
역할이 제거되지 않는 경우 예외
|
ExceptionIfAnyRolesFailToRemove | boolean |
true로 설정하면 단일 관리자 역할이 제거되지 않으면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 역할 수와 제거하지 못한 역할 수를 보고합니다. |
|
|
모든 역할을 제거하지 못한 경우 예외
|
ExceptionIfAllRolesFailToRemove | boolean |
true(기본값)로 설정하면 모든 관리자 역할을 제거하지 못하면 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 역할 수와 제거하지 못한 역할 수를 보고합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD 역할이 성공적으로 제거됨
|
AzureADRolesRemovedSuccessfully | integer |
사용자가 성공적으로 제거된 Azure AD 역할의 수입니다. |
|
Azure AD 역할을 제거하지 못했습니다.
|
AzureADRolesFailedToRemove | integer |
사용자가 제거하지 못한 Azure AD 역할의 수입니다. |
|
Azure AD 역할 마스터 오류 메시지 제거
|
RemoveAzureADRolesErrorMessage | string |
사용자가 일부 Azure AD 역할에서 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
모든 그룹에서 Active Directory 사용자 제거
구성원인 모든 Active Directory 그룹에서 Active Directory 사용자를 제거합니다. IA-Connect 가능한 한 많은 그룹에서 사용자를 제거하고 결과를 보고합니다. 이 작업은 사용자 계정에서만 작동하므로 이 작업을 사용하여 그룹 또는 컴퓨터의 그룹 멤버 자격을 제거할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | string |
모든 그룹에서 제거할 사용자입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
|
제외할 AD 그룹
|
GroupsToExcludeJSON | string |
제거에서 제외할 AD 그룹 목록(JSON 또는 CSV 형식)입니다. 예: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}](JSON 테이블 형식), ["Group 1", "Group 2"](JSON 배열 형식) 또는 그룹 1, 그룹 2(CSV 형식). 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
|
제외된 그룹이 없는 경우 예외
|
ExceptionIfExcludedGroupDoesNotExist | boolean |
true로 설정하면 제외된 그룹 중 하나가 없으면 예외(실패)가 발생합니다(IA-Connect 그룹 DN을 가져오기 위해 그룹을 조회해야 합니다). false(기본값)로 설정하면 제외된 그룹이 없으면 사용자가 해당 그룹의 멤버가 될 수 없으므로 무시됩니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
스레드로 실행
|
RunAsThread | boolean |
false로 설정하면 IA-Connect 에이전트는 작업을 즉시 실행하고 작업이 완료되면 결과를 반환하지만 작업자/RPA 명령 제한 시간보다 오래 걸리면 실패합니다. true로 설정하면 IA-Connect 에이전트는 이 작업을 에이전트 스레드로 실행하고 완료될 때까지 모니터링합니다. 이렇게 하면 작업자/RPA 명령 제한 시간보다 더 오랫동안 작업을 실행할 수 있습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 이 작업을 에이전트 스레드로 실행하고 '스레드를 기다리는 시간(초)'을 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. 이 작업을 실행하기만 하면 0(기본값)으로 설정됩니다(따라서 이 작업의 이전 인스턴스의 결과를 검색하지 않고 에이전트 스레드로 실행됨). |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 실행'이 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 이 작업을 실행하는 에이전트 스레드가 이 시간에 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 작업을 계속 실행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 나중에 '에이전트 스레드가 완료되기를 기다립니다.' 작업을 사용하여 에이전트 스레드가 완료되기를 기다렸다가 '스레드 ID에 대한 출력 데이터 검색' 입력이 에이전트 스레드 ID로 설정된 이 '모든 그룹에서 Active Directory 사용자 제거' 작업을 다시 실행하여 나중에 작업 결과를 검색할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹이 성공적으로 제거됨
|
ADGroupsRemovedSuccessfully | integer |
사용자가 성공적으로 제거된 AD 그룹의 수입니다. |
|
AD 그룹을 제거하지 못했습니다.
|
ADGroupsFailedToRemove | integer |
사용자가 제거하지 못한 AD 그룹의 수입니다. |
|
제거에서 제외된 AD 그룹
|
ADGroupsExcludedFromRemoval | integer |
제거에서 제외된 AD 그룹의 수입니다. |
|
AD 그룹 제거 오류 메시지
|
RemoveADGroupsMasterErrorMessage | string |
사용자가 일부 AD 그룹에서 제거하지 못한 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
|
스레드 ID
|
ThreadId | integer |
이 작업을 에이전트 스레드로 실행하는 경우 이 출력에는 작업 실행을 모니터링하고 작업이 완료되면 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
모든 그룹에서 Azure AD 사용자 제거
구성원인 모든 Azure Active Directory 그룹에서 Azure Active Directory 사용자를 제거합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
그룹을 제거하지 못한 경우 예외
|
ExceptionIfAnyGroupsFailToRemove | boolean |
true로 설정된 경우: 단일 그룹을 제거하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 일부 그룹(예: Office 365 그룹)은 제거되지 않을 수 있으므로 예외가 일반적일 수 있습니다. 예외가 발생하지 않으면 이 작업은 성공적으로 삭제된 그룹 수와 삭제하지 못한 그룹 수를 보고합니다. |
|
|
모든 그룹을 제거하지 못한 경우 예외
|
ExceptionIfAllGroupsFailToRemove | boolean |
true로 설정된 경우: 모든 그룹을 제거하지 못하면 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 삭제된 그룹 수와 삭제하지 못한 그룹 수를 보고합니다. |
|
|
호출당 최대 Azure AD 그룹
|
MaxAzureADGroupsPerCall | integer |
사용자가 많은 수의 Azure AD 그룹의 구성원인 경우 시간 제한이 발생할 수 있습니다. '호출당 최대 Azure AD 그룹' 값을 1 이상으로 설정하면 IA-Connect Orchestrator는 이 작업을 호출당 지정된 최대 그룹 수로 IA-Connect 디렉터 및 에이전트에 대한 여러 호출로 분할합니다. 예를 들어 5 및 14 그룹을 제거해야 하는 값을 설정하면 Orchestrator는 이를 5, 5, 4의 요청으로 분할합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD 그룹이 성공적으로 제거됨
|
AzureADGroupsRemovedSuccessfully | integer |
사용자가 성공적으로 제거된 Azure AD 그룹의 수입니다. |
|
Azure AD 그룹을 제거하지 못했습니다.
|
AzureADGroupsFailedToRemove | integer |
사용자가 제거하지 못한 Azure AD 그룹의 수입니다. |
|
Azure AD 그룹 마스터 오류 메시지 제거
|
RemoveAzureADGroupsErrorMessage | string |
사용자가 일부 Azure AD 그룹에서 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
모든 메일 그룹에서 Office 365 사서함 제거
구성원인 모든 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 가능 보안 그룹에서 사서함을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
MailboxIdentity | string |
구성원인 모든 메일 그룹 또는 메일 사용 가능 보안 그룹에서 제거할 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
|
보안 그룹 관리자 검사 무시
|
BypassSecurityGroupManagerCheck | boolean |
IA-Connect 에이전트 자동화 계정이 메일 그룹 또는 메일 사용 보안 그룹의 소유자가 아닌 경우 해당 그룹에서 구성원을 제거할 수 없습니다. 이 옵션을 true(기본값)로 설정하면 소유자 확인이 무시되지만 자동화 계정이 Exchange '조직 관리' 역할 그룹에 있거나 '역할 관리' 역할이 할당되어야 합니다. 이는 수정해야 하는 모든 그룹의 소유자가 아닌 Office 355 Exchange Online 그룹을 수정할 수 있는 권한을 부여하는 단일 역할입니다. |
|
|
그룹을 제거하지 못한 경우 예외
|
ExceptionIfAnyGroupsFailToRemove | boolean |
true로 설정된 경우: 사서함이 개별 그룹에서 제거되지 않으면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 그룹 수와 제거하지 못한 그룹 수를 보고합니다. |
|
|
모든 그룹을 제거하지 못한 경우 예외
|
ExceptionIfAllGroupsFailToRemove | boolean |
true(기본값)로 설정하면 사서함이 모든 그룹에서 제거되지 않으면 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 그룹 수와 제거하지 못한 그룹 수를 보고합니다. |
|
|
제외할 그룹 DN
|
GroupDNsToExcludeJSON | string |
제거에서 제외할 그룹 DN(고유 이름) 목록(JSON 또는 CSV 형식)입니다. 예: [{"GroupDN": "Group DN 1"}, {"GroupName": "Group DN 2"}](JSON 테이블 형식), ["Group DN 1", "Group DN 2"](JSON 배열 형식) 또는 "그룹 DN 1","그룹 DN 2"(CSV 형식). |
|
|
스레드로 실행
|
RunAsThread | boolean |
false로 설정하면 IA-Connect 에이전트는 작업을 즉시 실행하고 작업이 완료되면 결과를 반환하지만 작업자/RPA 명령 제한 시간보다 오래 걸리면 실패합니다. true로 설정하면 IA-Connect 에이전트는 이 작업을 에이전트 스레드로 실행하고 완료될 때까지 모니터링합니다. 이렇게 하면 작업자/RPA 명령 제한 시간보다 더 오랫동안 작업을 실행할 수 있습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 이 작업을 에이전트 스레드로 실행하고 '스레드를 기다리는 시간(초)'을 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. 이 작업을 실행하기만 하면 0(기본값)으로 설정됩니다(따라서 이 작업의 이전 인스턴스의 결과를 검색하지 않고 에이전트 스레드로 실행됨). |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 실행'이 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 이 작업을 실행하는 에이전트 스레드가 이 시간에 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 작업을 계속 실행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 에이전트 스레드가 완료되기를 기다리는 '에이전트 스레드가 성공적으로 완료되기를 기다립니다'를 사용하여 나중에 작업 결과를 검색한 다음, '스레드 ID에 대한 출력 데이터 검색' 입력이 에이전트 스레드 ID로 설정된 이 '모든 메일 그룹에서 Office 365 사서함 제거' 작업을 다시 실행할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
O365 그룹이 성공적으로 제거됨
|
O365GroupsRemovedSuccessfully | integer |
사서함이 성공적으로 제거된 O365 그룹 수입니다. |
|
O365 그룹을 제거하지 못했습니다.
|
O365GroupsFailedToRemove | integer |
사서함을 제거하지 못한 O365 그룹의 수입니다. |
|
제거에서 제외된 O365 그룹
|
O365GroupsExcludedFromRemoval | integer |
제거에서 제외된 O365 그룹의 수입니다(즉, 제외할 지정된 그룹 DN 중 하나와 일치). |
|
O365 그룹 마스터 오류 메시지 제거
|
RemoveO365GroupsErrorMessage | string |
일부 O365 그룹에서 사서함을 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
|
스레드 ID
|
ThreadId | integer |
이 작업을 에이전트 스레드로 실행하는 경우 이 출력에는 작업 실행을 모니터링하고 작업이 완료되면 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
사용 가능한 다음 계정 이름 가져오기
Active Directory 및 Exchange 계정 이름에 대한 명명 형식에 대한 세부 정보가 제공되면 사용 가능한 다음 예비 계정 이름의 세부 정보를 제공합니다. 지정된 사용자에 대해 만들 Active Directory 및 Exchange 계정을 결정하는 데 사용됩니다. 이 작업은 계정을 만들지 않으며 이름 가용성에 대한 정보를 제공합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름 (이름의 첫 부분)
|
FirstName | string |
사용자의 이름입니다. 계정 이름을 생성하는 데 사용자의 이름이 사용되지 않는 경우 비워 둡니다(드문 경우). |
|
|
중간 이름
|
MiddleName | string |
사용자의 중간 이름(선택 사항)입니다. 계정 이름을 생성하는 데 사용자의 중간 이름을 사용하지 않는 경우 비워 둡니다. |
|
|
성(姓)
|
LastName | string |
사용자의 마지막/가족/sur 이름입니다. 계정 이름을 생성하는 데 사용자의 성을 사용하지 않으면 비워 둡니다. |
|
|
필드 A
|
FieldA | string |
계정 이름을 생성하는 데 사용되는 추가 필드입니다. 계정 이름을 생성하는 데 추가 필드가 필요하지 않은 경우 비워 둡니다. |
|
|
필드 B
|
FieldB | string |
계정 이름을 생성하는 데 사용되는 추가 필드입니다. 계정 이름을 생성하는 데 추가 필드가 필요하지 않은 경우 비워 둡니다. |
|
|
필드 C
|
FieldC | string |
계정 이름을 생성하는 데 사용되는 추가 필드입니다. 계정 이름을 생성하는 데 추가 필드가 필요하지 않은 경우 비워 둡니다. |
|
|
필드 D
|
FieldD | string |
계정 이름을 생성하는 데 사용되는 추가 필드입니다. 계정 이름을 생성하는 데 추가 필드가 필요하지 않은 경우 비워 둡니다. |
|
|
M 시작 값
|
VariableMStartValue | integer |
필요에 따라 속성 형식에서 사용할 수 있는 {M} 변수의 초기 값을 설정하여 반복할 때마다 증가하는 변수를 나타낼 수 있습니다. |
|
|
N 시작 값
|
VariableNStartValue | integer |
필요에 따라 속성 형식으로 사용할 수 있는 {N} 변수의 초기 값을 설정하여 반복할 때마다 증가하는 변수를 나타낼 수 있습니다. |
|
|
X 시작 값
|
VariableXStartValue | integer |
필요에 따라 속성 형식으로 사용할 수 있는 {X} 변수의 초기 값을 설정하여 반복할 때마다 증가하는 변수를 나타낼 수 있습니다. |
|
|
최대 시도 수
|
MaxAttempts | integer |
IA-Connect 전에 시도된 최대 시도 횟수(다른 값 시도)는 사용 가능한 계정을 찾는 시도를 포기합니다. |
|
|
대체로 인해 다시 테스트
|
FallbackCausesRetest | boolean |
true로 설정된 경우: 규칙에 대한 가용성 검사에서 다른 형식으로 대체해야 하는 경우 테스트는 목록 맨 위에서 다시 시작하여 모든 속성이 동일한 형식(예: 기본, 기본, 기본 또는 대체, 대체, 대체)을 사용하는지 확인합니다. 이렇게 하면 결과가 동기화된 상태로 유지되며 권장되는 값입니다. 정확히 무엇을 하고 있는지 알고 있는 경우에만 false로 설정합니다. |
|
|
사용할 수 없는 숫자 목록
|
NumbersNotToUse | string |
M, N 또는 X 값에 사용할 수 없는 숫자의 쉼표로 구분된 목록입니다. 예: '13, 666'. |
|
|
입력에서 제거할 문자
|
CharactersToRemoveFromInputs | string |
입력에서 제거하려는 모든 문자가 포함된 문자열입니다(예: 사용자 이름에 잘못된 문자가 포함된 경우). 예: !@&&>^*. |
|
|
입력에서 발음 제거
|
RemoveDiacriticsFromInputs | boolean |
true로 설정하면 IA-Connect 입력 필드에서 모든 발음을 제거하려고 시도하여 문자를 같은 문자로 구분하여 발음을 뺀 음수로 바꿔야 합니다. 예: '급성 강조 a'를 'a'로 바꿉다. 단순 문자에 대한 직접 매핑이 없는 시나리오에서는 문자가 제거됩니다. 예: 독일 날카로운 S가 제거됩니다. |
|
|
입력에서 영숫자 이외 제거
|
RemoveNonAlphaNumericFromInputs | boolean |
true로 설정하면 IA-Connect 입력 필드에서 영숫자가 아닌 모든 문자를 제거합니다. |
|
|
시퀀스 A1
|
SequenceA1 | string |
사용 가능한 계정을 찾으려고 할 때마다 변경되는 값을 나타내기 위해 속성 형식으로 사용할 수 있는 {A1} 변수에 사용할 문자열의 쉼표로 구분된 목록입니다. 예를 들어 이 값에 'A,B,C,D,E,F'를 지정하는 경우 '{FirstName}{A1}' 형식은 {FirstName}A 다음에 {FirstName}B 등의 가용성을 확인합니다. |
|
|
재산
|
PropertyToCheck | string |
가용성을 확인할 계정 속성 |
|
|
포맷
|
PropertyNameFormat | string |
이 속성 값의 형식입니다. 예: {FirstName}. {LastName} 또는 {FirstName first 1}. {LastName} |
|
|
형식 대체(fallback)
|
PropertyNameFallbackFormat | string |
값을 이미 가져온 경우 이 속성 값의 대체 형식입니다. 예: {FirstName}. {LastName}{NN} 또는 {FirstName 처음 1}. {LastName}{NN} |
|
|
두 번째 대체 형식 지정
|
PropertyNameFallbackFormat2 | string |
값과 첫 번째 대체가 이미 수행된 경우 이 속성 값에 대한 두 번째 대체 형식입니다. 예: {FirstName}. {LastName}{NN} 또는 {FirstName 처음 1}. {LastName}{NN} |
|
|
값 최대 길이
|
PropertyNameMaxLength | integer |
잘라내기 전에 이 필드 값의 최대 길이입니다. |
|
|
최대 길이인 경우 잘라낼 필드
|
PropertyNameMaxLengthFieldToCut | string |
이 필드 값의 최대 길이를 초과하면 입력을 잘라내야 합니다. 예를 들어 성/패밀리 이름/성에서 잘라내 속성 값을 줄이려면 LastName을 선택합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 사용자 SAMAccountName
|
ActiveDirectorySAMAccountName | string |
사용 가능한 Active Directory 사용자 SAMAccountName(가용성을 확인하는 속성 중 하나인 경우)입니다. |
|
AD 사용자 계정 이름
|
ActiveDirectoryAccountName | string |
사용 가능한 Active Directory 사용자 계정 이름입니다(가용성을 확인하는 속성 중 하나인 경우). |
|
AD 사용자 계정 이름
|
ActiveDirectoryUPN | string |
사용 가능한 Active Directory 사용자 계정 이름입니다(가용성을 확인하는 속성 중 하나인 경우). |
|
AD 사용자 전자 메일 주소
|
ActiveDirectoryEmailAddress | string |
사용 가능한 Active Directory 전자 메일 주소입니다(가용성을 확인하는 속성 중 하나인 경우). |
|
Exchange 사서함 전자 메일 주소
|
ExchangeMailboxAddress | string |
사용 가능한 Exchange 전자 메일 사서함 주소(가용성을 확인하는 속성 중 하나인 경우)입니다. |
|
Exchange 사서함 별칭
|
ExchangeMailboxAlias | string |
사용 가능한 Exchange 사서함 별칭(가용성을 확인하는 속성 중 하나인 경우)입니다. |
|
Exchange 원격 사서함 주소
|
ExchangeRemoteMailboxAddress | string |
사용 가능한 Exchange 원격 사서함 주소(가용성을 확인하는 속성 중 하나인 경우)입니다. |
|
Azure AD 사용자 계정 이름
|
AzureADUPN | string |
사용 가능한 Azure Active Directory 사용자 계정 이름입니다(가용성을 확인하는 속성 중 하나인 경우). |
|
Office 365 사용자 계정 이름
|
Office365UPN | string |
사용 가능한 Office 365 사용자 계정 이름(가용성을 확인하는 속성 중 하나인 경우)입니다. |
|
Office 365 사서함 전자 메일 주소
|
Office365MailboxEmailAddress | string |
사용 가능한 Office 365 전자 메일 사서함 주소(가용성을 확인할 속성 중 하나인 경우)입니다. |
|
M 최종 값
|
MValue | integer |
사용된 경우 변수 M의 최종 값입니다. |
|
N 최종 값
|
NValue | integer |
사용된 경우 N 변수의 최종 값입니다. |
|
X 최종 값
|
XValue | integer |
사용된 경우 변수 X의 최종 값입니다. |
|
사용된 인덱스 서식 지정
|
FormatIndexUsed | integer |
속성을 일치시키는 데 사용된 형식의 인덱스입니다. 1 = 기본 형식, 2 = 대체 형식, 3 = 두 번째 대체 형식입니다. 이렇게 하면 초기 형식으로 인해 사용 가능한 계정이 발생했는지 또는 IA-Connect 제공된 다른 형식으로 대체해야 하는지 여부를 알 수 있습니다. |
사용자 DN에서 Active Directory OU 가져오기
유틸리티 함수입니다. Active Directory 사용자의 DN(고유 이름)이 지정된 경우 사용자가 있는 OU(조직 구성 단위)를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 DN
|
UserDN | True | string |
검색 사용자의 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 OU
|
UserOU | string |
사용자가 있는 OU(조직 구성 단위)입니다. |
사용자로부터 Microsoft Exchange 사서함 권한 제거
지정된 사서함 사용자, 사용자 또는 보안 그룹에서 사서함 권한을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
사용자
|
User | True | string |
사서함 사용 권한에서 제거할 사용자입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사용자를 지정할 수 있습니다. |
|
액세스 권한
|
AccessRights | True | string |
사서함에 대한 사용자의 사용 권한에서 제거할 액세스 권한입니다. 사용 가능한 옵션은 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' 및 'ReadPermission'입니다. 여러 권한을 제거하려면 쉼표로 구분된 목록으로 지정합니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeRemoveMailboxPermissionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
사용자로부터 Office 365 사서함 권한 제거
지정된 사서함 사용자, 사용자 또는 보안 그룹에서 Microsoft Exchange Online 또는 Office 365 사서함 권한을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
사용자
|
User | True | string |
사서함 사용 권한에서 제거할 사서함 사용자, 사용자 또는 메일 사용 가능 보안 그룹입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
액세스 권한
|
AccessRights | True | string |
사서함에 대한 사용자의 사용 권한에서 제거할 액세스 권한입니다. 사용 가능한 옵션은 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' 및 'ReadPermission'입니다. 여러 권한을 제거하려면 쉼표로 구분된 목록으로 지정합니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365RemoveMailboxPermissionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
사용자에 대한 Microsoft Exchange Online 사서함 만들기
아직 사서함이 없는 온-프레미스 Active Directory의 기존 사용자에 대한 Microsoft Exchange Online 또는 Office 365(원격) 사서함 또는 보관 사서함을 만듭니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다. 이 작업을 사용하여 기존 원격 사서함을 보관할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
사서함을 만들려는 기존 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. |
|
|
표시 이름
|
DisplayName | string |
사서함의 표시 이름입니다. 주소 목록에 표시됩니다. |
|
|
원격 라우팅 주소
|
RemoteRoutingAddress | string |
이 사용자가 연결된 Microsoft Exchange Online 또는 Office 365 사서함의 SMTP 주소입니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. |
|
|
보관 사서함 만들기
|
Archive | boolean |
Microsoft Exchange Online 또는 Office 365에서 보관 사서함을 추가로 만들려면 true로 설정합니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 원격 사서함 사용 작업의 출력입니다. |
|
새 사서함 DN
|
NewMailboxDN | string |
새로 만든(사용) 사서함의 DN(고유 이름)입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 GUID
|
NewMailboxGUID | string |
새로 만든(사용) 사서함의 GUID입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
사용자에 대한 Microsoft Exchange Online 사서함 사용 안 함
기존 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 사용하지 않도록 설정합니다. 요청은 하이브리드 배포를 위해 설정해야 하는 온-프레미스 Microsoft Exchange 서버를 통해 전송됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365(원격) 사서함의 ID입니다. Active Directory 개체 ID, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID 또는 UPN(사용자 계정 이름)으로 Microsoft Exchange Online 또는 Office 365(원격) 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 사서함 사용 안 함 작업의 출력입니다. |
사용자에 대한 Microsoft Exchange 사서함 만들기
사서함이 없는 기존 사용자에 대한 Microsoft Exchange 사서함을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
사서함을 만들려는 기존 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
Alias
|
Alias | string |
사용자의 Exchange 별칭(메일 애칭이라고도 함)입니다. 전자 메일 주소 정책을 사용하는 경우 기본 SMTP 전자 메일 주소(예: alias@mydomain.com)의 이름 구성 요소를 생성하는 데 사용됩니다. 전자 메일 주소 정책을 사용하도록 설정하지 않은 경우 대신 기본 SMTP 주소를 설정할 수 있습니다. |
|
|
표시 이름
|
DisplayName | string |
사서함의 표시 이름입니다. 주소 목록에 표시됩니다. |
|
|
연결된 도메인 컨트롤러
|
LinkedDomainController | string |
연결된 사서함을 만드는 경우 사용자 계정이 있는 포리스트에서 도메인 컨트롤러를 지정할 수 있습니다. 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 사용합니다. |
|
|
연결된 마스터 계정
|
LinkedMasterAccount | string |
연결된 사서함을 만드는 경우 사서함이 연결된 계정을 지정할 수 있습니다. 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), GUID 또는 이름(예: 'User1')으로 계정을 지정할 수 있습니다. |
|
|
데이터베이스
|
Database | string |
새 데이터베이스를 포함할 Exchange 데이터베이스입니다. 고유 이름, GUID 또는 이름으로 데이터베이스를 지정할 수 있습니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
받는 사람에게 사용되는 기본 반환 전자 메일 주소입니다. '전자 메일 주소 정책'을 사용하도록 설정하여 대신 '별칭'을 사용하거나(그리고 정책이 별칭에서 기본 SMTP 주소를 생성함) 전자 메일 주소 정책을 사용하지 않도록 설정하는 경우 이를 설정할 수 없습니다. |
|
|
전자 메일 주소 정책 사용
|
EmailAddressPolicyEnabled | boolean |
이 받는 사람에게 적용된 전자 메일 주소 정책에 따라 전자 메일 주소를 자동으로 업데이트하려면 true로 설정합니다. 전자 메일 주소 정책을 사용하는 경우 일반적으로 기본 SMTP 주소를 설정하는 기능에 영향을 줍니다. 기능을 사용하지 않도록 설정하려면 false로 설정하여 전자 메일 주소를 수동으로 설정할 수 있는 모든 권한을 부여합니다. 이 옵션을 설정하지 않으려면 비워 둡니다(예: 기존 또는 기본값으로 둡니다). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
사서함 사용 작업의 출력(JSON 형식)입니다. |
|
새 사서함 DN
|
NewMailboxDN | string |
새로 만든(사용) 사서함의 DN(고유 이름)입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
|
새 사서함 GUID
|
NewMailboxGUID | string |
새로 만든(사용) 사서함의 GUID입니다. 이 사서함의 추가 작업에 사용할 수 있는 사서함의 고유 식별자입니다. |
사용자에 대한 Microsoft Exchange 사서함 사용 안 함
기존 Microsoft Exchange 사서함을 사용하지 않도록 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
JSON 형식의 사서함 사용 안 함 작업의 출력입니다. |
사용자에게 Microsoft Exchange 사서함 권한 추가
지정된 사서함 사용자, 사용자 또는 보안 그룹에 사서함 권한을 할당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange 사서함의 ID입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
사용자
|
User | True | string |
사서함 권한에 추가할 사용자입니다. 이름, 별칭, 고유 이름(예: CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사용자를 지정할 수 있습니다. |
|
액세스 권한
|
AccessRights | True | string |
사서함에 대한 사용자의 권한에 할당할 액세스 권한입니다. 사용 가능한 옵션은 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' 및 'ReadPermission'입니다. 여러 권한을 할당하려면 쉼표로 구분된 목록으로 지정합니다. |
|
자동 매핑
|
AutoMapping | boolean |
true로 설정하면 사서함 및 사용자 계정에는 이 사용자로 로그인할 때 Outlook에서 사서함을 자동으로 여는 몇 가지 추가 속성이 설정됩니다. 이 작업은 적용하는 데 몇 분 정도 걸릴 수 있습니다. false로 설정하면 추가 속성이 설정되지 않으며 Outlook에서 사서함을 자동으로 열지 않습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ExchangeAddMailboxPermissionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
사용자에게 Office 365 사서함 권한 추가
지정된 사서함 사용자, 사용자 또는 보안 그룹에 Microsoft Exchange Online 또는 Office 365 사서함 권한을 할당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사서함 ID
|
Identity | True | string |
Microsoft Exchange Online 또는 Office 365 사서함의 ID입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
사용자
|
User | True | string |
사서함 권한을 받을 사서함 사용자, 사용자 또는 메일 사용 보안 그룹입니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
액세스 권한
|
AccessRights | True | string |
사서함에 대한 사용자의 권한에 할당할 액세스 권한입니다. 사용 가능한 옵션은 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' 및 'ReadPermission'입니다. 여러 권한을 할당하려면 쉼표로 구분된 목록으로 지정합니다. |
|
자동 매핑
|
AutoMapping | boolean |
true로 설정하면 사서함 및 사용자 계정에는 이 사용자로 로그인할 때 Outlook에서 사서함을 자동으로 여는 몇 가지 추가 속성이 설정됩니다. 이 작업은 적용하는 데 몇 분 정도 걸릴 수 있습니다. false로 설정하면 추가 속성이 설정되지 않으며 Outlook에서 사서함을 자동으로 열지 않습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
O365AddMailboxPermissionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
새 Azure AD Microsoft 365 그룹 만들기
새 Azure Active Directory Microsoft 365 그룹을 만듭니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
표시 이름
|
DisplayName | True | string |
그룹의 표시 이름입니다. |
|
Description
|
Description | string |
그룹 설명입니다. |
|
|
메일 애칭
|
MailNickname | string |
그룹 전자 메일 주소를 형성하는 데 사용되는 이메일 애칭입니다. |
|
|
그룹 표시 유형
|
GroupVisibility | string |
공용(기본값)으로 설정하면 누구나 그룹의 콘텐츠를 볼 수 있으며 누구나 그룹에 참가할 수 있습니다. 비공개로 설정된 경우 멤버만 그룹의 콘텐츠를 볼 수 있으며 소유자만 그룹에 새 멤버를 추가하거나 조인 요청을 승인할 수 있습니다. |
|
|
그룹이 있는지 확인
|
CheckGroupExists | boolean |
true로 설정하면 IA-Connect 그룹이 있는지 확인하고, 그룹이 존재하는 경우 IA-Connect 아무 것도 수행할 필요 없이 해당 그룹에 대한 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 그룹을 만들며, 이로 인해 그룹 이름이 중복될 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
배포 그룹 만들기 작업의 출력(JSON 형식)입니다. 일반적으로 생성된 그룹의 세부 정보를 보유합니다. |
|
그룹이 이미 있음
|
GroupAlreadyExists | boolean |
그룹이 이미 있는 경우 그룹이 존재하므로 IA-Connect 작업을 수행할 필요가 없음을 알리기 위해 true로 설정됩니다. |
|
만든 그룹 개체 ID
|
CreatedGroupObjectId | string |
만든 그룹(또는 기존 그룹)의 개체 ID입니다. |
새 Azure AD 보안 그룹 만들기
새 Azure Active Directory 보안 그룹을 만듭니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
표시 이름
|
DisplayName | True | string |
그룹의 표시 이름입니다. |
|
Description
|
Description | string |
그룹 설명입니다. |
|
|
그룹이 있는지 확인
|
CheckGroupExists | boolean |
true로 설정하면 IA-Connect 그룹이 있는지 확인하고, 그룹이 존재하는 경우 IA-Connect 아무 것도 수행할 필요 없이 해당 그룹에 대한 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 그룹을 만들며, 이로 인해 그룹 이름이 중복될 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
배포 그룹 만들기 작업의 출력(JSON 형식)입니다. 일반적으로 생성된 그룹의 세부 정보를 보유합니다. |
|
그룹이 이미 있음
|
GroupAlreadyExists | boolean |
그룹이 이미 있는 경우 그룹이 존재하므로 IA-Connect 작업을 수행할 필요가 없음을 알리기 위해 true로 설정됩니다. |
|
만든 그룹 개체 ID
|
CreatedGroupObjectId | string |
만든 그룹(또는 기존 그룹)의 개체 ID입니다. |
새 Microsoft Exchange 메일 그룹 만들기
새 Microsoft Exchange 메일 그룹 또는 메일 사용 보안 그룹을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 이름
|
Name | True | string |
새 그룹의 고유 이름입니다. |
|
Alias
|
Alias | string |
새 그룹의 별칭(메일 애칭이라고도 함)입니다. SMTP 주소를 지정하지 않으면 별칭을 사용하여 전자 메일 주소의 이름 구성 요소(예: alias@mydomain.com)를 생성합니다. |
|
|
표시 이름
|
DisplayName | string |
그룹의 표시 이름입니다. 주소 목록에 표시됩니다. |
|
|
비고
|
Notes | string |
개체에 대한 선택적 참고 사항입니다. |
|
|
관리 기준
|
ManagedBy | string |
그룹의 소유자입니다. 소유자를 지정하지 않으면 그룹을 만든 사용자가 소유자가 됩니다. 소유자는 사서함, 메일 사용자 또는 메일 사용 보안 그룹일 수 있습니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
|
구성원
|
Members | string |
새 그룹에 추가할 쉼표로 구분된 멤버 목록입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 멤버를 지정할 수 있습니다. |
|
|
조직 구성 단위
|
OrganizationalUnit | string |
그룹을 저장할 Active Directory의 OU(조직 구성 단위)입니다. 고유 이름 형식(예: OU=대상 OU,OU=London, DC=mydomain,DC=local), GUID 형식 또는 경로(예: MyGroups\London)로 OU를 지정할 수 있습니다. 비워 두면 그룹이 '사용자' OU에 만들어집니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
새 그룹에 사용되는 기본 반환 전자 메일 주소입니다. |
|
|
회원 출발 제한
|
MemberDepartRestriction | string |
메일 그룹을 떠나는 멤버에 대한 제한을 지정할 수 있습니다. 'Open'은 기본값이며 멤버가 승인 없이 그룹을 떠날 수 있도록 허용하며, '닫힘'은 구성원이 그룹을 떠나는 것을 제한합니다. 사용자가 보안 그룹에서 자신을 제거할 수 없으므로 이 옵션은 보안 그룹에 대해 무시됩니다. |
|
|
멤버 조인 제한
|
MemberJoinRestriction | string |
그룹을 만든 후 메일 그룹에 가입하는 멤버에 대한 제한을 지정할 수 있습니다. 'Open'을 사용하면 구성원이 승인 없이 그룹에 가입할 수 있습니다. 'Closed'(기본값)는 구성원의 그룹 가입을 제한하고, 'ApprovalRequired'는 구성원이 그룹 가입을 요청할 수 있도록 허용하며 그룹 소유자가 요청을 수락하면 추가됩니다. 사용자가 보안 그룹에 자신을 추가할 수 없으므로 이 옵션은 보안 그룹에 대해 무시됩니다. |
|
|
보낸 사람 인증 필요
|
RequireSenderAuthenticationEnabled | boolean |
그룹이 인증된(내부) 보낸 사람의 메시지만 수락하도록 지정하려면 true로 설정합니다. 모든 보낸 사람의 메시지를 수락하려면 false로 설정합니다. |
|
|
그룹 형식
|
Type | string |
만들 그룹 유형을 지정합니다. '배포'는 기본값이며 메일 그룹을 만듭니다. '보안'은 메일 사용 보안 그룹을 만드는 데 사용됩니다. |
|
|
그룹이 이미 있는 경우 예외
|
ErrorIfGroupAlreadyExists | boolean |
그룹이 이미 있는 경우 예외가 발생해야 하나요? 그룹이 이미 있는 경우(예: 이미 생성된 경우) 아무 작업도 수행하지 않도록 false로 설정합니다. 이미 존재하는 그룹이 오류인 경우 true로 설정합니다(예: 존재하지 않을 것으로 예상됨). |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
배포 그룹 만들기 작업의 출력(JSON 형식)입니다. 일반적으로 생성된 그룹의 세부 정보를 보유합니다. |
|
그룹이 이미 있음
|
GroupAlreadyExists | boolean |
그룹이 이미 있고 '그룹이 이미 있는 경우 예외'가 false로 설정된 경우 그룹이 이미 존재하기 때문에 실제로 생성되지 않았음을 알리기 위해 true로 설정됩니다. |
|
새 그룹 DN
|
NewGroupDN | string |
새로 만든 그룹의 DN(고유 이름)입니다. 이 그룹에 대한 추가 작업에 사용할 수 있는 그룹의 고유 식별자입니다. |
|
새 그룹 GUID
|
NewGroupGUID | string |
새로 만든(사용) 그룹의 GUID입니다. 이 그룹에 대한 추가 작업에 사용할 수 있는 그룹의 고유 식별자입니다. |
새 Office 365 메일 그룹 만들기
새 Microsoft Exchange Online 또는 Office 365 메일 그룹 또는 메일 사용 가능 보안 그룹을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 이름
|
Name | True | string |
새 그룹의 고유 이름입니다. |
|
Alias
|
Alias | string |
새 그룹의 별칭(메일 애칭이라고도 함)입니다. SMTP 주소를 지정하지 않으면 별칭을 사용하여 전자 메일 주소의 이름 구성 요소(예: alias@mydomain.com)를 생성합니다. |
|
|
표시 이름
|
DisplayName | string |
그룹의 표시 이름입니다. 주소 목록에 표시됩니다. |
|
|
비고
|
Notes | string |
개체에 대한 선택적 참고 사항입니다. |
|
|
관리 기준
|
ManagedBy | string |
그룹의 소유자입니다. 소유자를 지정하지 않으면 그룹을 만든 사용자가 소유자가 됩니다. 소유자는 사서함, 메일 사용자 또는 메일 사용 보안 그룹일 수 있습니다. 이름, 별칭, 개체 ID(예: UUID/GUID 값), 전자 메일 주소, GUID, SAMAccountName(비 Active Directory 연결 환경의 사용자에도 SAMAccountName이 있음) 또는 UPN(사용자 계정 이름)으로 사서함을 지정할 수 있습니다. |
|
|
구성원
|
Members | string |
새 그룹에 추가할 쉼표로 구분된 멤버 목록입니다. 이름, 별칭, 고유 이름(예: CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), 전자 메일 주소 또는 GUID로 멤버를 지정할 수 있습니다. |
|
|
조직 구성 단위
|
OrganizationalUnit | string |
그룹을 저장할 Azure Active Directory의 OU(조직 구성 단위)입니다. 고유 이름 형식(예: OU=대상 OU, OU=London, DC=mydomain,DC=local) 또는 GUID 형식으로 OU를 지정할 수 있습니다. |
|
|
기본 SMTP 주소
|
PrimarySmtpAddress | string |
새 그룹에 사용되는 기본 반환 전자 메일 주소입니다. |
|
|
회원 출발 제한
|
MemberDepartRestriction | string |
그룹을 떠나는 멤버에 대한 제한을 지정할 수 있습니다. 'Open'은 기본값이며 멤버가 승인 없이 그룹을 떠날 수 있도록 허용하며, '닫힘'은 구성원이 그룹을 떠나는 것을 제한합니다. |
|
|
멤버 조인 제한
|
MemberJoinRestriction | string |
그룹을 만든 후 그룹에 가입하는 멤버에 대한 제한을 지정할 수 있습니다. 'Open'을 사용하면 구성원이 승인 없이 그룹에 가입할 수 있습니다. 'Closed'(기본값)는 구성원의 그룹 가입을 제한하고, 'ApprovalRequired'는 구성원이 그룹 가입을 요청할 수 있도록 허용하며 그룹 소유자가 요청을 수락하면 추가됩니다. |
|
|
보낸 사람 인증 필요
|
RequireSenderAuthenticationEnabled | boolean |
그룹이 인증된(내부) 보낸 사람의 메시지만 수락하도록 지정하려면 true로 설정합니다. 모든 보낸 사람의 메시지를 수락하려면 false로 설정합니다. |
|
|
그룹 형식
|
Type | string |
만들 그룹 유형을 지정합니다. '배포'는 기본값이며 메일 그룹을 만듭니다. '보안'은 메일 사용 보안 그룹을 만드는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 결과 JSON
|
PowerShellJSONOutput | string |
배포 그룹 만들기 작업의 출력(JSON 형식)입니다. 일반적으로 생성된 그룹의 세부 정보를 보유합니다. |
|
그룹이 이미 있음
|
GroupAlreadyExists | boolean |
그룹이 이미 있는 경우 그룹이 실제로 생성되지 않았음을 알리기 위해 true로 설정됩니다. |
|
만든 그룹 DN
|
CreatedGroupDN | string |
만든 그룹(또는 기존 그룹)의 DN(고유 이름)입니다. |
|
만든 그룹 GUID
|
CreatedGroupGUID | string |
만든 그룹(또는 기존 그룹)의 GUID입니다. |
|
만든 그룹 ID
|
CreatedGroupIdentity | string |
만든 그룹(또는 기존 그룹)의 ID입니다. |
실수로 인한 삭제로부터 보호되는 Active Directory 사용자 설정
실수로 삭제되지 않도록 Active Directory 계정을 보호하거나 보호하지 않도록 설정합니다. 실수로 삭제하지 않도록 계정을 보호하는 경우 보호를 제거할 때까지 해당 계정을 삭제할 수 없습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
UserIdentity | True | string |
Active Directory 사용자의 ID입니다. 고유 이름(예: CN=User1,OU=My Users, DC=mydomain,DC=local), GUID, SID, SAMAccountName/ 2K 이전 이름(예: 'User1') 또는 이름(예: 'User1')으로 사용자를 지정할 수 있습니다. |
|
실수로 삭제되지 않도록 보호됨
|
ProtectedFromAccidentalDeletion | True | boolean |
실수로 삭제하지 않도록 사용자를 보호하려면 true로 설정합니다. 실수로 인한 삭제로부터 보호를 제거하려면 false로 설정합니다. |
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
ActiveDirectorySetADUserProtectedFromAccidentalDeletionByIdentityResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
여러 Active Directory 그룹 구성원 제거
기존 Active Directory 그룹에서 하나 이상의 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 제거합니다. IA-Connect 그룹에서 가능한 한 많은 멤버를 제거하고 결과를 보고합니다. 그룹 및 그룹 멤버가 서로 다른 도메인에 있는 경우 그룹 및 멤버 모두에 대해 DN(고유 이름)을 지정해야 합니다. 일부 개체가 그룹의 멤버가 아닌 경우 성공으로 계산됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
|
그룹 구성원
|
GroupMembersJSON | string |
AD 그룹에서 제거할 멤버(일반적으로 사용자, 그룹 또는 컴퓨터)의 목록(JSON 또는 CSV 형식)입니다. 예: [{"MemberName": "User 1"}, {"MemberName": "User 2"}](JSON 테이블 형식), ["User 1", "User 2"](JSON 배열 형식) 또는 User 1,User 2(CSV 형식). 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
|
멤버를 제거하지 못한 경우 예외
|
ExceptionIfAnyMembersFailToRemove | boolean |
true로 설정된 경우: 단일 멤버를 제거하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 멤버 수와 제거하지 못한 멤버 수를 보고합니다. |
|
|
모든 멤버를 제거하지 못한 경우 예외
|
ExceptionIfAllMembersFailToRemove | boolean |
true로 설정된 경우: 모든 멤버를 제거하지 못하는 경우에만 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 멤버 수와 제거하지 못한 멤버 수를 보고합니다. |
|
|
단일 호출에서 모든 멤버 제거
|
RemoveAllMembersInASingleCall | boolean |
true로 설정하면 모든 멤버가 단일 작업으로 그룹에서 제거됩니다. 이 작업은 더 빨라지지만 단일 멤버가 없거나 제거되지 않으면 멤버가 제거되지 않으며 '예외' 입력 옵션에 관계없이 예외가 발생합니다. false(기본값)로 설정하면 각 멤버가 개별적으로 제거되고 IA-Connect 에이전트는 성공적으로 제거된 수와 제거하지 못한 횟수를 계산합니다. 도메인 간 그룹에서 멤버를 제거하는 경우 이 입력을 false로 설정하는 것이 좋습니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹 구성원이 성공적으로 제거됨
|
ADGroupMembersRemovedSuccessfully | integer |
AD 그룹에서 성공적으로 제거된 멤버 수입니다. |
|
AD 그룹 구성원을 제거하지 못했습니다.
|
ADGroupMembersFailedToRemove | integer |
AD 그룹에서 제거하지 못한 멤버 수입니다. |
|
AD 그룹 구성원 제거 오류 메시지
|
RemoveADGroupMembersMasterErrorMessage | string |
일부 멤버가 AD 그룹에서 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 Active Directory 그룹 구성원 추가
하나 이상의 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 기존 Active Directory 그룹에 추가합니다. IA-Connect 가능한 한 많은 멤버를 그룹에 추가하고 결과를 보고합니다. 그룹 및 그룹 멤버가 서로 다른 도메인에 있는 경우 그룹 및 멤버 모두에 대해 DN(고유 이름)을 지정해야 합니다. 일부 개체가 이미 그룹의 멤버인 경우 성공으로 계산됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
그룹 ID
|
GroupIdentity | string |
Active Directory 그룹의 ID입니다. 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
|
그룹 구성원
|
GroupMembersJSON | string |
AD 그룹에 추가할 멤버(일반적으로 사용자, 그룹 또는 컴퓨터)의 목록(JSON 또는 CSV 형식)입니다. 예: [{"MemberName": "User 1"}, {"MemberName": "User 2"}](JSON 테이블 형식), ["User 1", "User 2"](JSON 배열 형식) 또는 User 1,User 2(CSV 형식). 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
|
멤버를 추가하지 못한 경우 예외
|
ExceptionIfAnyMembersFailToAdd | boolean |
true로 설정하면 단일 멤버를 추가하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 추가된 멤버 수와 추가하지 못한 멤버 수를 보고합니다. |
|
|
모든 멤버를 추가하지 못한 경우 예외
|
ExceptionIfAllMembersFailToAdd | boolean |
true로 설정하면 모든 멤버가 추가하지 못하는 경우에만 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 추가된 멤버 수와 추가하지 못한 멤버 수를 보고합니다. |
|
|
단일 호출에서 모든 멤버 추가
|
AddAllMembersInASingleCall | boolean |
true로 설정하면 모든 멤버가 단일 작업으로 그룹에 추가됩니다. 이 작업은 더 빨라지지만 단일 멤버가 없거나 추가에 실패하는 경우 '예외' 입력 옵션에 관계없이 멤버가 추가되지 않고 예외가 발생합니다. false(기본값)로 설정하면 각 멤버가 개별적으로 추가되고 IA-Connect 에이전트는 성공적으로 추가된 수와 추가하지 못한 횟수를 계산합니다. 도메인에서 그룹에 구성원을 추가하는 경우 이 입력을 false로 설정하는 것이 좋습니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹 구성원이 성공적으로 추가됨
|
ADGroupMembersAddedSuccessfully | integer |
AD 그룹에 성공적으로 추가된 멤버 수입니다. |
|
AD 그룹 구성원을 추가하지 못했습니다.
|
ADGroupMembersFailedToAdd | integer |
AD 그룹에 추가하지 못한 멤버 수입니다. |
|
AD 그룹 구성원 추가 오류 메시지
|
AddADGroupMembersMasterErrorMessage | string |
일부 멤버가 AD 그룹에 추가하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 관리자 역할에 Azure AD 사용자 할당
하나 이상의 기존 Azure Active Directory 관리자 역할에 Azure Active Directory 사용자(또는 다른 개체)를 할당합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
역할 개체 ID 또는 표시 이름
|
RolesJSON | string |
JSON 또는 CSV 형식으로 사용자에게 할당할 관리자 역할 목록입니다. 예: [{"역할": "애플리케이션 개발자"}, {"역할": "Exchange 관리자"}](JSON 테이블 형식), ["애플리케이션 개발자", "Exchange 관리자"](JSON 배열 형식) 또는 애플리케이션 개발자, Exchange 관리자(CSV 형식). 표시 이름(예: "애플리케이션 개발자") 또는 ObjectId(예: UUID/GUID 값)로 AAD 관리자 역할을 지정할 수 있습니다. |
|
|
역할이 할당되지 않는 경우 예외
|
ExceptionIfAnyRolesFailToAssign | boolean |
true로 설정하면 단일 Azure AD 관리자 역할이 할당되지 않으면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 할당된 Azure AD 관리자 역할 수와 할당하지 못한 수에 대해 보고합니다. |
|
|
모든 역할을 할당하지 못한 경우 예외
|
ExceptionIfAllRolesFailToAssign | boolean |
true로 설정하면 모든 Azure AD 관리자 역할이 할당되지 않는 경우에만 예외(실패)가 발생합니다(예: 성공 및 일부 실패 없음). 예외가 발생하지 않으면 이 작업은 성공적으로 할당된 Azure AD 관리자 역할 수와 할당하지 못한 수에 대해 보고합니다. |
|
|
디렉터리 범위 ID
|
DirectoryScopeId | string |
할당되는 모든 역할에 대한 디렉터리 범위 ID입니다. 예: / 전체 테넌트를 나타내고 /GUID는 앱 등록을 나타내고 /administrativeUnits/GUID는 관리 단위를 나타냅니다. |
|
|
먼저 사용자 역할 멤버 자격 확인
|
CheckUserRoleMembershipsFirst | boolean |
true(기본값)로 설정하면 IA-Connect 역할에 할당하기 전에 사용자의 역할 할당을 확인합니다. 사용자가 역할에 이미 할당된 경우 IA-Connect 아무 작업도 수행하지 않고도 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 즉시 사용자를 역할에 할당하므로 사용자가 역할에 이미 할당된 경우 오류가 발생합니다. |
|
|
역할 ID가 있는지 확인
|
CheckRoleIdsExist | boolean |
true(기본값)로 설정하고 하나 이상의 역할이 개체 ID 형식으로 제공되는 경우 IA-Connect 해당 역할 ID가 유효한지 다시 확인합니다. 잘못된 개체 ID를 제공할 때 Azure AD에서 받은 오류 메시지가 유용하지 않기 때문에 이 메시지가 권장됩니다. false로 설정하면 IA-Connect 제공된 역할 ID의 유효성을 다시 확인하지 않습니다. 이는 더 빠릅니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공적으로 할당된 Azure AD 역할
|
AzureADRolesAssignedSuccessfully | integer |
성공적으로 할당된 Azure AD 역할의 수입니다. |
|
Azure AD 역할을 할당하지 못했습니다.
|
AzureADRolesFailedToAssign | integer |
할당하지 못한 Azure AD 역할의 수입니다. |
|
Azure AD 역할 할당 오류 메시지
|
AssignAzureADRolesMasterErrorMessage | string |
일부 역할을 할당하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 관리자 역할에서 Azure AD 사용자 제거
하나 이상의 기존 Azure Active Directory 관리자 역할에서 Azure Active Directory 사용자(또는 다른 개체)를 제거합니다. 이 작업은 사용자의 역할 할당 목록을 반복하고 일치하는 항목을 제거하므로 제거할 존재하지 않는 역할을 지정하는 경우 오류가 트리거되지 않습니다(사용자가 해당 역할에 없으면 아무 시도도 수행되지 않음). 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
역할 개체 ID 또는 표시 이름
|
RolesJSON | string |
JSON 또는 CSV 형식으로 사용자에게 할당할 관리자 역할 목록입니다. 예: [{"역할": "애플리케이션 개발자"}, {"역할": "Exchange 관리자"}](JSON 테이블 형식), ["애플리케이션 개발자", "Exchange 관리자"](JSON 배열 형식) 또는 애플리케이션 개발자, Exchange 관리자(CSV 형식). 표시 이름(예: "애플리케이션 개발자") 또는 ObjectId(예: UUID/GUID 값)로 AAD 관리자 역할을 지정할 수 있습니다. |
|
|
디렉터리 범위 ID
|
DirectoryScopeId | string |
제거를 위해 지정된 역할 할당이 일치해야 하는 선택적 디렉터리 범위 ID입니다. 예: /는 전체 테넌트를 나타내며 디렉터리 범위 ID가 제거되는 명명된 역할 할당만 발생합니다. /GUID는 앱 등록을 나타내고 /administrativeUnits/GUID는 관리 단위를 나타냅니다. 디렉터리 범위에 관계없이 명명된 역할 할당을 제거하려면 * 또는 빈 값을 지정합니다. |
|
|
역할이 제거되지 않는 경우 예외
|
ExceptionIfAnyRolesFailToRemove | boolean |
true로 설정된 경우: 단일 Azure AD 관리자 역할이 제거되지 않으면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 Azure AD 관리자 역할 수와 제거하지 못한 수에 대해 보고합니다. |
|
|
모든 역할을 제거하지 못한 경우 예외
|
ExceptionIfAllRolesFailToRemove | boolean |
true로 설정하면 모든 Azure AD 관리자 역할이 제거되지 않는 경우에만 예외(실패)가 발생합니다(예: 성공 및 일부 실패 없음). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 Azure AD 관리자 역할 수와 제거하지 못한 수에 대해 보고합니다. |
|
|
역할이 없는 경우 예외
|
ExceptionIfRoleDoesNotExist | boolean |
true로 설정된 경우: 제거에 지정된 역할 중 하나가 없으면 예외(실패)가 발생합니다. false(기본값)로 설정하면 제거에 대해 지정된 역할이 없으면 사용자가 할당할 수 없으므로 무시됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD 역할이 성공적으로 제거됨
|
AzureADRolesRemovedSuccessfully | integer |
제거된 Azure AD 역할의 수입니다. 실제로 제거된 역할만 계산됩니다(사용자가 포함되지 않은 역할은 계산되지 않음). |
|
Azure AD 역할을 제거하지 못했습니다.
|
AzureADRolesFailedToRemove | integer |
제거하지 못한 Azure AD 역할의 수입니다. |
|
Azure AD 역할 제거 오류 메시지
|
RemoveAzureADRolesMasterErrorMessage | string |
일부 역할을 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 그룹에 Active Directory 개체 추가
여러 기존 Active Directory 그룹에 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 추가합니다. IA-Connect 가능한 한 많은 그룹에 개체를 추가하고 결과를 보고합니다. 개체가 이미 지정된 그룹 중 하나 이상의 멤버인 경우 성공으로 계산됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개체 ID
|
UserIdentity | True | string |
하나 이상의 그룹에 추가할 개체(일반적으로 사용자, 그룹 또는 컴퓨터)입니다. 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
추가할 AD 그룹
|
GroupNamesJSON | string |
JSON 또는 CSV 형식으로 개체를 추가할 AD 그룹의 목록입니다. 예: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}](JSON 테이블 형식), ["Group 1", "Group 2"](JSON 배열 형식) 또는 그룹 1, 그룹 2(CSV 형식). 고유 이름(예: CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'Group1')으로 그룹을 지정할 수 있습니다. 표시 이름 또는 그룹 이름을 사용할 수 없습니다(그룹 이름은 종종 사용할 수 있는 2K 이전 이름과 동일하지만). |
|
|
그룹을 추가하지 못한 경우 예외
|
ExceptionIfAnyGroupsFailToAdd | boolean |
true로 설정하면 단일 그룹을 추가하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 추가된 그룹 수와 추가하지 못한 그룹 수를 보고합니다. |
|
|
모든 그룹을 추가하지 못한 경우 예외
|
ExceptionIfAllGroupsFailToAdd | boolean |
true로 설정된 경우: 모든 그룹을 추가하지 못하는 경우에만 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 추가된 그룹 수와 추가하지 못한 그룹 수를 보고합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
호출당 최대 그룹
|
MaxGroupsPerCall | integer |
추가를 위해 많은 수의 AD 그룹을 지정하면 시간 제한이 발생할 수 있습니다. '호출당 최대 그룹' 값을 1 이상으로 설정하면 IA-Connect Orchestrator는 이 작업을 호출당 지정된 최대 그룹 수로 IA-Connect 디렉터 및 에이전트에 대한 여러 호출로 분할합니다. IA-Connect 9.3에서 처음 사용할 수 있습니다. 예를 들어 추가를 위해 5 및 14 그룹의 값을 설정하는 경우 Orchestrator는 이를 5, 5, 4의 요청으로 분할합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹이 성공적으로 추가됨
|
ADGroupsAddedSuccessfully | integer |
개체가 성공적으로 추가된 AD 그룹의 수입니다. |
|
AD 그룹을 추가하지 못했습니다.
|
ADGroupsFailedToAdd | integer |
개체를 추가하지 못한 AD 그룹의 수입니다. |
|
AD 그룹 추가 오류 메시지
|
AddADGroupsMasterErrorMessage | string |
개체가 일부 AD 그룹에 추가하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 그룹에 Azure AD 사용자 추가
개체 ID 또는 표시 이름으로 그룹을 지정하는 여러 기존 Azure Active Directory 그룹에 Azure Active Directory 사용자를 추가합니다. IA-Connect 가능한 한 많은 그룹에 사용자를 추가하고 결과를 보고합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
추가할 Azure AD 그룹
|
GroupNamesJSON | string |
사용자를 JSON 또는 CSV 형식으로 추가할 Azure AD 그룹의 ID 또는 표시 이름 목록입니다. 예: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}](JSON 테이블 형식), ["Group 1", "Group 2"](JSON 배열 형식) 또는 그룹 1, 그룹 2(CSV 형식). |
|
|
그룹을 추가하지 못한 경우 예외
|
ExceptionIfAnyGroupsFailToAdd | boolean |
true로 설정하면 단일 그룹을 추가하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 일부 그룹(예: Office 365 그룹)은 예외가 일반화될 수 있도록 추가하지 않을 수 있습니다. 예외가 발생하지 않으면 이 작업은 성공적으로 추가된 그룹 수와 추가하지 못한 그룹 수를 보고합니다. |
|
|
모든 그룹을 추가하지 못한 경우 예외
|
ExceptionIfAllGroupsFailToAdd | boolean |
true로 설정된 경우: 모든 그룹을 추가하지 못하는 경우에만 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 추가된 그룹 수와 추가하지 못한 그룹 수를 보고합니다. |
|
|
먼저 사용자 그룹 멤버 자격 확인
|
CheckUserGroupMembershipsFirst | boolean |
true로 설정하면 IA-Connect 그룹에 추가하기 전에 사용자의 그룹 멤버 자격을 확인합니다. 사용자가 이미 그룹의 구성원인 경우 IA-Connect 아무 작업도 수행하지 않고도 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 즉시 사용자를 그룹에 추가하므로 사용자가 이미 그룹에 있는 경우 오류가 발생합니다. |
|
|
호출당 최대 Azure AD 그룹
|
MaxAzureADGroupsPerCall | integer |
추가를 위해 많은 수의 Azure AD 그룹을 지정하면 시간 제한이 발생할 수 있습니다. '호출당 최대 Azure AD 그룹' 값을 1 이상으로 설정하면 IA-Connect Orchestrator는 이 작업을 호출당 지정된 최대 그룹 수로 IA-Connect 디렉터 및 에이전트에 대한 여러 호출로 분할합니다. 예를 들어 5 및 14 그룹을 제거해야 하는 값을 설정하면 Orchestrator는 이를 5, 5, 4의 요청으로 분할합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD 그룹이 성공적으로 추가됨
|
AzureADGroupsAddedSuccessfully | integer |
사용자가 성공적으로 추가된 Azure AD 그룹의 수입니다. |
|
Azure AD 그룹을 추가하지 못했습니다.
|
AzureADGroupsFailedToAdd | integer |
사용자가 추가하지 못한 Azure AD 그룹의 수입니다. |
|
Azure AD 그룹 마스터 오류 메시지 추가
|
AddAzureADGroupsMasterErrorMessage | string |
사용자가 일부 Azure AD 그룹에 추가하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 그룹에서 Active Directory 개체 제거
여러 기존 Active Directory 그룹에서 Active Directory 개체(일반적으로 사용자, 그룹 또는 컴퓨터)를 제거합니다. IA-Connect 가능한 한 많은 그룹에서 개체를 제거하고 결과를 보고합니다. 개체가 지정된 그룹 중 하나 이상의 멤버가 아닌 경우 성공으로 계산됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개체 ID
|
UserIdentity | True | string |
하나 이상의 그룹에서 제거할 개체(일반적으로 사용자, 그룹 또는 컴퓨터)입니다. 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
제거할 AD 그룹
|
GroupNamesJSON | string |
JSON 또는 CSV 형식으로 개체를 제거할 AD 그룹의 목록입니다. 예: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}](JSON 테이블 형식), ["Group 1", "Group 2"](JSON 배열 형식) 또는 그룹 1, 그룹 2(CSV 형식). 고유 이름(예: CN=User1,OU=My Groups, DC=mydomain,DC=local), GUID, SID 또는 SAMAccountName/2K 이전 이름(예: 'User1')으로 사용자 또는 그룹을 지정할 수 있습니다. 고유 이름 또는 컴퓨터 이름(2K 이전)과 $(예: VM01$)로 컴퓨터를 지정할 수 있습니다. |
|
|
그룹을 제거하지 못한 경우 예외
|
ExceptionIfAnyGroupsFailToRemove | boolean |
true로 설정된 경우: 단일 그룹을 제거하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 그룹 수와 제거하지 못한 그룹 수를 보고합니다. |
|
|
모든 그룹을 제거하지 못한 경우 예외
|
ExceptionIfAllGroupsFailToRemove | boolean |
true로 설정된 경우: 모든 그룹을 제거하지 못하는 경우에만 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 제거된 그룹 수와 제거하지 못한 그룹 수를 보고합니다. |
|
|
AD 서버
|
ADServer | string |
요청된 작업을 수행하기 위해 연결할 DC(Active Directory 도메인 컨트롤러)의 선택적 이름 또는 FQDN(정규화된 도메인 이름)입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. |
|
|
호출당 최대 그룹
|
MaxGroupsPerCall | integer |
제거를 위해 많은 수의 AD 그룹을 지정하면 시간 제한이 발생할 수 있습니다. '호출당 최대 그룹' 값을 1 이상으로 설정하면 IA-Connect Orchestrator는 이 작업을 호출당 지정된 최대 그룹 수로 IA-Connect 디렉터 및 에이전트에 대한 여러 호출로 분할합니다. IA-Connect 9.3에서 처음 사용할 수 있습니다. 예를 들어 5 및 14 그룹의 값을 설정하면 오케스트레이터는 이를 5, 5, 4의 요청으로 분할합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
AD 그룹이 성공적으로 제거됨
|
ADGroupsRemovedSuccessfully | integer |
개체가 성공적으로 제거된 AD 그룹의 수입니다. |
|
AD 그룹을 제거하지 못했습니다.
|
ADGroupsFailedToRemove | integer |
개체를 제거하지 못한 AD 그룹의 수입니다. |
|
AD 그룹 제거 오류 메시지
|
RemoveADGroupsMasterErrorMessage | string |
일부 AD 그룹에서 개체를 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
여러 그룹에서 Azure AD 사용자 제거
그룹이 개체 ID 또는 표시 이름으로 지정된 여러 기존 Azure Active Directory 그룹에서 Azure Active Directory 사용자를 제거합니다. IA-Connect 가능한 한 많은 그룹에서 사용자를 제거하고 결과를 보고합니다. 이 작업은 메일 그룹 또는 메일 사용 보안 그룹을 수정할 수 없습니다. 대신 Office 365 Exchange Online 작업을 사용합니다. 이 작업은 Azure에 연결하는 데 사용된 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID 또는 UPN
|
UserObjectId | True | string |
Azure Active Directory 사용자의 ID입니다. UPN(예: ) 또는 ObjectId(예: user@mydomain.onmicrosoft.comUUID/GUID 값)로 사용자를 지정할 수 있습니다. |
|
제거할 Azure AD 그룹
|
GroupNamesJSON | string |
JSON 또는 CSV 형식으로 사용자를 제거할 Azure AD 그룹의 ID 또는 표시 이름 목록입니다. 예: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}](JSON 테이블 형식), ["Group 1", "Group 2"](JSON 배열 형식) 또는 그룹 1, 그룹 2(CSV 형식). |
|
|
그룹을 제거하지 못한 경우 예외
|
ExceptionIfAnyGroupsFailToRemove | boolean |
true로 설정된 경우: 단일 그룹을 제거하지 못하면 예외(실패)가 발생합니다(즉, 100개% 성공이 요구 사항임). 일부 그룹(예: Office 365 그룹)은 제거되지 않을 수 있으므로 예외가 일반적일 수 있습니다. 예외가 발생하지 않으면 이 작업은 성공적으로 삭제된 그룹 수와 삭제하지 못한 그룹 수를 보고합니다. |
|
|
모든 그룹을 제거하지 못한 경우 예외
|
ExceptionIfAllGroupsFailToRemove | boolean |
true로 설정된 경우: 모든 그룹을 제거하지 못하면 예외(실패)가 발생합니다(예: 성공 없음 및 일부 실패). 예외가 발생하지 않으면 이 작업은 성공적으로 삭제된 그룹 수와 삭제하지 못한 그룹 수를 보고합니다. |
|
|
먼저 사용자 그룹 멤버 자격 확인
|
CheckUserGroupMembershipsFirst | boolean |
true로 설정하면 IA-Connect 각 그룹에서 제거를 시도하기 전에 사용자의 그룹 멤버 자격을 확인합니다. 사용자가 특정 그룹의 구성원이 아닌 경우 IA-Connect 아무 작업도 수행하지 않고 해당 그룹에 대한 성공을 보고합니다. false로 설정하면 IA-Connect 확인하지 않고 지정된 각 그룹에서 사용자를 즉시 제거하므로 사용자가 그룹에 없는 경우 오류가 발생합니다. |
|
|
호출당 최대 Azure AD 그룹
|
MaxAzureADGroupsPerCall | integer |
사용자가 많은 수의 Azure AD 그룹의 구성원인 경우 시간 제한이 발생할 수 있습니다. '호출당 최대 Azure AD 그룹' 값을 1 이상으로 설정하면 IA-Connect Orchestrator는 이 작업을 호출당 지정된 최대 그룹 수로 IA-Connect 디렉터 및 에이전트에 대한 여러 호출로 분할합니다. 예를 들어 5 및 14 그룹을 제거해야 하는 값을 설정하면 Orchestrator는 이를 5, 5, 4의 요청으로 분할합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Azure AD 그룹이 성공적으로 제거됨
|
AzureADGroupsRemovedSuccessfully | integer |
사용자가 성공적으로 제거된 Azure AD 그룹의 수입니다. |
|
Azure AD 그룹을 제거하지 못했습니다.
|
AzureADGroupsFailedToRemove | integer |
사용자가 제거하지 못한 Azure AD 그룹의 수입니다. |
|
Azure AD 그룹 마스터 오류 메시지 제거
|
RemoveAzureADGroupsErrorMessage | string |
사용자가 일부 Azure AD 그룹에서 제거하지 못하고 예외가 발생하지 않은 경우 이 오류 메시지는 문제에 대한 세부 정보를 제공합니다. |
인증서를 사용하여 Azure AD에 연결
IA-Connect Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에 연결합니다. 다른 Azure AD 작업을 실행하기 전에 이 작업(또는 '자격 증명을 사용하여 Azure AD에 연결')을 실행해야 합니다. 이 작업을 수행하려면 Azure AD에서 인증서를 사용하여 Azure 서비스 주체 및 Azure AD 앱 등록을 설정해야 작동하지만 MFA(2FA)를 요구하지 않는다는 장점이 있습니다. 이 작업은 Azure AD v2 또는 Microsoft Graph PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Azure AD 앱 등록 ID
|
ApplicationId | True | string |
인증서를 포함하고 자동화 작업을 수행하는 데 필요한 Azure AD 역할이 있는 Azure AD 앱 등록의 애플리케이션 ID입니다. 이 Azure AD 앱 등록은 이전에 관리자가 설정했어야 합니다. |
|
인증서 지문
|
CertificateThumbprint | True | string |
인증에 사용되는 인증서의 지문입니다. 이 인증서는 이전에 만들어졌어야 하며 IA-Connect 자동화 작업을 수행하는 컴퓨터와 Azure AD 앱 등록에 모두 존재해야 합니다. |
|
Azure 테넌트 ID
|
TenantId | True | string |
연결할 Azure 테넌트 ID입니다. 인증서를 사용하여 인증할 때 지정해야 합니다. |
|
사용할 API
|
APIToUse | string |
Azure AD에 연결할 때 사용할 API입니다. 설정되면 IA-Connect 발급된 모든 추가 Azure AD 명령이 이 API를 사용합니다. 자동(기본값)으로 설정하면 설치된 PowerShell 모듈이 검사되고 Microsoft Graph 사용자 PowerShell 모듈, Azure AD v2 PowerShell 모듈 순서대로 선택됩니다. Azure AD v2 PowerShell 모듈은 2024년 3월 30일에 사용되지 않으므로 Microsoft Graph 사용자 PowerShell 모듈을 사용하는 것이 좋습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenAzureADv2PowerShellRunspaceWithCertificateResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
인증서를 사용하여 Office 365에 연결
Office 365 PowerShell 모듈을 사용하여 office 365에 IA-Connect 연결합니다. 다른 Office 365 작업을 실행하기 전에 이 작업(또는 '자격 증명으로 Office 365에 연결')을 실행해야 합니다. 이 작업을 수행하려면 Azure AD 앱이 작동하기 전에 인증서를 사용하여 Azure AD 앱을 등록하고 올바른 역할을 설정해야 하지만 MFA(2FA)를 요구하지 않는다는 장점이 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Azure AD 앱 등록 애플리케이션 ID
|
ApplicationId | True | string |
인증서를 포함하고 자동화 작업을 수행하는 데 필요한 Azure AD 역할이 있는 Azure AD 앱 등록의 애플리케이션 ID입니다. 이 Azure AD 앱 등록은 이전에 관리자가 설정했어야 합니다. |
|
인증서 지문
|
CertificateThumbprint | True | string |
인증에 사용되는 인증서의 지문입니다. 이 인증서는 이전에 만들어졌어야 하며 IA-Connect 자동화 작업을 수행하는 컴퓨터와 Azure AD 앱 등록에 모두 존재해야 합니다. |
|
조직
|
Organization | True | string |
인증에 사용할 조직입니다. 예: mytestenvironment.onmicrosoft.com. |
|
Exchange URL
|
ExchangeURL | string |
연결할 Microsoft Exchange 온라인 서버의 선택적 URL입니다. 사용자 지정 URL이 있는 경우에만 사용합니다. |
|
|
연결 방법
|
ConnectionMethod | string |
Microsoft Exchange에 연결하는 데 사용해야 하는 메서드입니다. 'EXO V1'은 원래 Microsoft Exchange Online PowerShell이며 인증서를 지원하지 않으므로 옵션으로 사용할 수 없습니다. 'EXO V2'는 IA-Connect 에이전트를 실행하는 컴퓨터에서 실행되며 'ExchangeOnlineManagement' v2 PowerShell 모듈을 설치해야 하는 최신 Microsoft Exchange Online PowerShell v2 모듈을 사용합니다. |
|
|
연결되지 않은 경우에만 연결
|
OnlyConnectIfNotAlreadyConnected | boolean |
false로 설정된 경우: 이 작업은 IA-Connect 이미 연결된 경우에도 항상 Office 365 Exchange Online에 연결됩니다. true(기본값)로 설정된 경우: IA-Connect 동일한 설정으로 Office 365 Exchange Online에 이미 연결되어 있고 Office 365 Exchange Online 연결이 응답하는 경우 IA-Connect 연결이 이미 설정되어 있으므로 아무 작업도 수행하지 않습니다. |
|
|
로컬로 가져올 명령 유형
|
CommandTypesToImportLocally | string |
'EXO V2' 연결 방법(인증서 인증에 필요)은 Office 365 또는 Exchange Online PowerShell 명령을 로컬로 가져옵니다. 이 옵션을 사용하면 가져올 PowerShell 명령을 선택할 수 있습니다. 이 목록을 최소한으로 유지하면 메모리 사용량과 연결 시간이 모두 줄어듭니다. 'All'(기본값: 이전 버전과의 호환성)은 모든 PS 명령을 가져옵니다. 'IA-Connect만'(권장 옵션)은 IA-Connect 사용하는 PS 명령만 가져옵니다(추가 PS 명령을 지정할 수 있습니다). 'Specified'는 지정한 PS 명령만 가져오며 지정하지 않은 PS 명령에 따라 일부 IA-Connect 작업이 중단될 수 있습니다. |
|
|
로컬로 가져올 추가 명령
|
AdditionalCommandsToImportLocallyCSV | string |
'IA-Connect만' 또는 '지정한' PS 명령을 가져오도록 선택한 경우 가져올 추가 PS 명령의 쉼표로 구분된 목록을 지정할 수 있습니다. 예: 'Get-Mailbox,New-Mailbox,New-DistributionGroup'. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenO365PowerShellRunspaceWithCertificateResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
자격 증명을 사용하여 Active Directory에 연결
Active Directory PowerShell 명령을 실행할 때 사용할 대체 계정을 지정할 수 있습니다. 이 작업은 이 작업 후에 실행된 모든 Active Directory 명령에 영향을 줍니다. 이 작업을 사용하지 않으면 모든 Active Directory PowerShell 명령이 IA-Connect 에이전트가 실행 중인 사용자 계정으로 실행됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 이름
|
Username | True | string |
Active Directory 명령을 실행할 때 사용할 계정의 사용자 이름입니다. 'DOMAIN\username' 형식(예: TESTDOMAIN\admin) 또는 'username@domainFQDN'(예: )로 사용자 이름을 지정할 수 있습니다 admin@testdomain.local. |
|
암호
|
Password | True | password |
Active Directory 명령을 실행할 때 사용할 계정의 암호입니다. |
|
원격 컴퓨터
|
RemoteComputer | string |
인증할 DC(Active Directory 도메인 컨트롤러) 또는 멤버 서버의 FQDN(정규화된 도메인 이름) 또는 모든 Active Directory 작업을 전달할 이름입니다. 비워 두면 사이트 설정을 사용하여 DC(Active Directory 도메인 컨트롤러)가 자동으로 결정됩니다. 도메인 컨트롤러 대신 멤버 서버를 입력하는 경우 해당 멤버 서버에 Active Directory PowerShell 모듈/RSAT가 설치되어 있어야 합니다. |
|
|
SSL 사용
|
UseSSL | boolean |
SSL을 사용하여 원격 WSMan 엔드포인트에 연결하려면 true로 설정합니다. |
|
|
대체 TCP 포트
|
AlternativeTCPPort | integer |
기본 WSMan TCP/5985(비 SSL) 또는 TCP/5986(SSL)을 사용하지 않는 경우 대체 TCP 포트로 설정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenActiveDirectoryPowerShellRunspaceWithCredentialsResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
자격 증명을 사용하여 Azure AD에 연결
IA-Connect Azure Active Directory(Microsoft Entra ID, Azure AD 또는 AAD라고도 함)에 연결합니다. 다른 Azure AD 작업을 실행하기 전에 이 작업(또는 '인증서를 사용하여 Azure AD에 연결')을 실행해야 합니다. 이 작업을 수행하려면 MFA(2FA)를 사용하지 않는 계정이 필요하거나 UI 자동화 모듈을 사용하여 2FA 구성 요소(즉, 일회성 암호 인증 팝업)를 자동화해야 합니다. 또는 '인증서를 사용하여 Azure AD에 연결' 작업을 사용합니다. 이 작업은 Azure AD v2 또는 Microsoft Graph 사용자 PowerShell 모듈을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 이름
|
Username | True | string |
Azure AD v2 PowerShell 명령을 실행할 때 사용할 계정의 사용자 이름입니다. |
|
암호
|
Password | True | password |
Azure AD v2 PowerShell 명령을 실행할 때 사용할 계정의 암호입니다. |
|
Azure 테넌트 ID
|
TenantId | string |
연결할 선택적 Azure 테넌트 ID입니다. 이 값을 비워 두면 제공된 사용자 계정과 연결된 기본 테넌트가 사용됩니다. |
|
|
사용할 API
|
APIToUse | string |
Azure AD에 연결할 때 사용할 API입니다. 설정되면 IA-Connect 발급된 모든 추가 Azure AD 명령이 이 API를 사용합니다. 자동(기본값)으로 설정하면 설치된 PowerShell 모듈이 검사되고 Microsoft Graph 사용자 PowerShell 모듈, Azure AD v2 PowerShell 모듈 순서대로 선택됩니다. Azure AD v2 PowerShell 모듈은 2024년 3월 30일에 사용되지 않으므로 Microsoft Graph 사용자 PowerShell 모듈을 사용하는 것이 좋습니다. |
|
|
인증 범위
|
AuthenticationScope | string |
이 Azure AD 로그인 세션에서 모든 자동화 작업을 수행하는 데 필요한 권한 범위입니다. 기본적으로 IA-Connect 사용자, 그룹 및 라이선스 할당을 수정할 수 있도록 사용 권한 범위를 요청합니다. 이 설정은 Microsoft Graph 사용자 PowerShell 모듈을 사용하여 연결할 때만 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenAzureADv2PowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
자격 증명을 사용하여 Office 365에 연결
Office 365 PowerShell 모듈을 사용하여 office 365에 IA-Connect 연결합니다. 다른 Office 365 작업을 실행하기 전에 이 작업(또는 '인증서를 사용하여 Office 365에 연결')을 실행해야 합니다. 이 작업을 수행하려면 MFA(2FA)가 필요하지 않은 계정이 필요하거나 UI 자동화 모듈을 사용하여 2FA 구성 요소(즉, 일회성 암호 인증 팝업)를 자동화해야 합니다. 또는 '인증서를 사용하여 Office 365에 연결' 작업을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 이름
|
Office365Username | True | string |
Office 365 PowerShell 명령을 실행할 때 사용할 계정의 사용자 이름입니다. |
|
암호
|
Office365Password | True | password |
Office 365 PowerShell 명령을 실행할 때 사용할 계정의 암호입니다. |
|
Exchange URL
|
ExchangeURL | string |
연결할 Microsoft Exchange 온라인 서버의 선택적 URL입니다. 사용자 지정 URL이 있는 경우에만 사용합니다. |
|
|
연결 방법
|
ConnectionMethod | string |
Microsoft Exchange에 연결하는 데 사용해야 하는 메서드입니다. 'EXO V1 로컬' 및 'EXO V1 원격'은 모두 IA-Connect 에이전트를 실행하는 컴퓨터에서 실행되고 추가 PowerShell 모듈이 필요하지 않지만 결국 더 이상 사용되지 않는 원래 Microsoft Exchange Online PowerShell을 사용합니다. 'EXO V1 local'은 원격 Exchange Runspace를 로컬로 가져오고 로컬로 명령을 실행합니다. 'EXO V1 원격'은 원격 Exchange Runspace에서 직접 실행되며 보안 제한으로 인해 일반 PowerShell 스크립트를 실행할 수 없습니다. 'EXO V2'는 IA-Connect 에이전트를 실행하는 컴퓨터에서 실행되며 'ExchangeOnlineManagement' v2 PowerShell 모듈을 설치해야 하는 최신 Microsoft Exchange Online PowerShell v2 모듈을 사용합니다. |
|
|
연결되지 않은 경우에만 연결
|
OnlyConnectIfNotAlreadyConnected | boolean |
false로 설정된 경우: 이 작업은 IA-Connect 이미 연결된 경우에도 항상 Office 365 Exchange Online에 연결됩니다. true(기본값)로 설정된 경우: IA-Connect 동일한 설정으로 Office 365 Exchange Online에 이미 연결되어 있고 Office 365 Exchange Online 연결이 응답하는 경우 IA-Connect 연결이 이미 설정되어 있으므로 아무 작업도 수행하지 않습니다. |
|
|
로컬로 가져올 명령 유형
|
CommandTypesToImportLocally | string |
'EXO v1 local' 및 'EXO V2' 연결 메서드는 Office 365 또는 Exchange Online PowerShell 명령을 로컬로 가져옵니다. 이 옵션을 사용하면 가져올 PowerShell 명령을 선택할 수 있습니다. 이 목록을 최소한으로 유지하면 메모리 사용량과 연결 시간이 모두 줄어듭니다. 'All'(기본값: 이전 버전과의 호환성)은 모든 PS 명령을 가져옵니다. 'IA-Connect만'(권장 옵션)은 IA-Connect 사용하는 PS 명령만 가져옵니다(추가 PS 명령을 지정할 수 있습니다). 'Specified'는 지정한 PS 명령만 가져오며 지정하지 않은 PS 명령에 따라 일부 IA-Connect 작업이 중단될 수 있습니다. |
|
|
로컬로 가져올 추가 명령
|
AdditionalCommandsToImportLocallyCSV | string |
'EXO v1 local' 또는 'EXO V2' 연결 메서드를 사용하고 'IA-Connect만' 또는 '지정한' PS 명령을 가져오도록 선택한 경우 가져올 추가 PS 명령의 쉼표로 구분된 목록을 지정할 수 있습니다. 예: 'Get-Mailbox,New-Mailbox,New-DistributionGroup'. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
OpenO365PowerShellRunspaceResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |