사서함 가져오기 활동

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기2분
  • 사서함 가져오기 활동은 지정된 사용자 또는 Exchange 서버의 모든 사서함에 대한 사서함을 Microsoft 가져옵니다.

    이 활동은 Microsoft Exchange Get-Mailbox 명령을 구현합니다.

    워크플로우 편집기에서 이 활동에 접근하려면 사용자 지정 탭을 선택한 후 사용자 지정 활동 > Exchange > 사서함.
    주:
    이 활동은 Geneva 이전 릴리스에서 사용할 수 있는 동일한 이름으로 Exchange 활동을 대체합니다. 이전 버전에서 작성된 워크플로우 중 사용되지 않는 활동을 사용하는 워크플로우가 있는 경우, Geneva로 업그레이드한 후에도 워크플로우는 계속 정상적으로 작동합니다. 그러나 모든 새 워크플로우는 이 활동의 사용자 지정 버전을 사용해야 합니다. 이 활동은 워크플로우 관리자에게 입력 및 출력 변수를 데이터버스에 저장할 수 있는 기능을 제공하는 기능으로 PowerShell 활동 디자이너빌드되었습니다.

    입력 변수

    표 1. 사서함 입력 변수 가져오기
    변수 설명
    호스트 이름 활동이 상호작용하는 Exchange 서버의 호스트 이름. 이 변수에 IP 주소를 입력하지 마십시오.
    도메인 Exchange 서버의 할당된 도메인 이름입니다.
    사용자 이 활동에서 검색해야 하는 사서함의 사용자. 사용자를 지정하지 않으면 활동에서 Exchange 서버의 모든 사서함을 가져옵니다. 활동은 이 값을 Exchange에 계정 교환 변수로 전달합니다.
    parameters JSON(JavaScript Object Notation)으로 작성된 Exchange 서버에 전달할 선택적 매개변수입니다. Exchange 활동은 PSCredential 개체와 같은 개체를 참조하는 매개 변수를 전달할 수 없습니다. 일반 텍스트는 해당 데이터 형식이 필요한 매개 변수에 대한 SecureString 개체로 자동 변환됩니다.
    활동 변수의 매개변수를 포함하여 중복 매개변수를 지정하는 활동 또는 잘못된 형식의 JSON을 저장하는 활동을 저장하려고 하면 경고 메시지가 나타납니다.
    주:
    스위치 매개 변수(예: ForceUpgrade)를 전달할 때는 "parameter":"true".

    출력 변수

    표 2. 사서함 출력 변수 가져오기
    변수 설명
    결과 성공 또는 실패.
    오류 작업이 실패할 경우의 오류 메시지입니다.
    출력 Exchange 서버의 원시 XML 페이로드. 이 데이터에는 모든 Exchange 특성이 포함됩니다.

    조건

    표 3. 사서함 조건 가져오기
    조건 설명
    성공 활동이 지정된 사서함의 특성을 검색하는 데 성공했습니다.
    실패 활동에서 지정된 사서함의 속성을 검색하지 못했습니다.