특정 문서 버전을 사용하여 명령 실행 - AWS Systems Manager

• AWS Systems Manager Change Manager는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 AWS Systems Manager Change Manager 가용성 변경을 참조하세요.

 

• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 Amazon CloudWatch 대시보드 설명서를 참조하세요.

특정 문서 버전을 사용하여 명령 실행

문서 버전 파라미터를 사용하여 명령 실행 시 사용할 AWS Systems Manager 문서 버전을 지정할 수 있습니다. 이 파라미터에는 다음 옵션 중 하나를 지정할 수 있습니다.

  • $DEFAULT

  • $LATEST

  • 버전 번호

문서 버전 파라미터를 실행하여 명령을 실행하려면 다음 절차를 사용합니다.

Linux
로컬 Linux 시스템에서 AWS CLI를 사용하여 명령을 실행하려면

  1. 아직 하지 않은 경우 AWS Command Line Interface(AWS CLI)를 설치하고 구성합니다.

    자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트를 참조하세요.

  2. 사용할 수 있는 모든 문서 나열

    이 명령을 실행하면 AWS Identity and Access Management(IAM) 권한에 따라 계정에 사용할 수 있는 문서를 모두 나열합니다.

    aws ssm list-documents

  3. 다음 명령을 실행하여 문서의 여러 버전을 확인합니다. document name을 사용자의 정보로 바꿉니다.

    aws ssm list-document-versions \
    --name "document name"

  4. 다음 명령을 실행하여 SSM 문서 버전을 사용하는 명령을 실행합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다.

    aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --parameters commands="echo Hello" \
    --instance-ids instance-ID \
    --document-version '$LATEST'
Windows
로컬 Windows 시스템에서 AWS CLI를 사용하여 명령을 실행하려면

  1. 아직 하지 않은 경우 AWS Command Line Interface(AWS CLI)를 설치하고 구성합니다.

    자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트를 참조하세요.

  2. 사용할 수 있는 모든 문서 나열

    이 명령을 실행하면 AWS Identity and Access Management(IAM) 권한에 따라 계정에 사용할 수 있는 문서를 모두 나열합니다.

    aws ssm list-documents

  3. 다음 명령을 실행하여 문서의 여러 버전을 확인합니다. document name을 사용자의 정보로 바꿉니다.

    aws ssm list-document-versions ^
    --name "document name"

  4. 다음 명령을 실행하여 SSM 문서 버전을 사용하는 명령을 실행합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다.

    aws ssm send-command ^
    --document-name "AWS-RunShellScript" ^
    --parameters commands="echo Hello" ^
    --instance-ids instance-ID ^
    --document-version "$LATEST"
PowerShell
Tools for PowerShell을 사용하여 명령을 실행하려면

  1. 아직 설치하지 않은 경우 AWS Tools for PowerShell(Tools for Windows PowerShell)을 설치하고 구성합니다.

    자세한 내용은 AWS Tools for PowerShell 설치를 참조하세요.

  2. 사용할 수 있는 모든 문서 나열

    이 명령을 실행하면 AWS Identity and Access Management(IAM) 권한에 따라 계정에 사용할 수 있는 문서를 모두 나열합니다.

    Get-SSMDocumentList

  3. 다음 명령을 실행하여 문서의 여러 버전을 확인합니다. document name을 사용자의 정보로 바꿉니다.

    Get-SSMDocumentVersionList `
    -Name "document name"

  4. 다음 명령을 실행하여 SSM 문서 버전을 사용하는 명령을 실행합니다. 각 example resource placeholder를 사용자의 정보로 바꿉니다.

    Send-SSMCommand `
    -DocumentName "AWS-RunShellScript" `
    -Parameter @{commands = "echo helloWorld"} `
    -InstanceIds "instance-ID" `
    -DocumentVersion $LATEST