sqlps 유틸리티

구문

sqlps 
[ [ [ -NoLogo ][ -NoExit ][ -NoProfile ]
      [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]
  ]
    [ -Command { -
               | script_block [ -args argument_array ]
               | string [ command_parameters ]
                 }
  ]
]
[ -? | -Help ]

인수

• -NoLogo
  sqlps가 시작될 때 저작권 배너를 표시하지 않도록 지정합니다.

• -NoExit
  시작 명령이 완료된 후에도 sqlps가 계속 실행되도록 지정합니다.

• -NoProfile
  sqlps가 사용자 프로필을 로드하지 않도록 지정합니다. 사용자 프로필은 PowerShell 세션에서 사용하도록 공통적으로 사용되는 별칭, 함수 및 변수를 기록합니다.

• -OutPutFormat { Text | XML }
  sqlps 출력 형식이 텍스트 문자열(Text) 또는 직렬화된 CLIXML 형식(XML)이 되도록 지정합니다.

• -InPutFormat { Text | XML }
  sqlps에 대한 입력 형식이 텍스트 문자열(Text) 또는 직렬화된 CLIXML 형식(XML)이 되도록 지정합니다.

• -Command
  sqlps에 대한 명령이 실행되도록 지정합니다. sqlps 유틸리티는 -NoExit가 지정되지 않은 경우 명령을 실행한 후 종료됩니다. -Command 뒤에는 다른 스위치를 지정하지 마십시오. 이 경우 스위치가 명령 매개 변수로 읽힙니다.

• -
  -Command-sqlps가 표준 입력으로부터 입력을 읽도록 지정합니다.

• script_block [ -argsargument_array ]
  PowerShell 명령 블록이 실행되도록 지정하고 블록은 중괄호 {}로 묶어야 합니다. Script_block은 sqlps가 PowerShell 또는 sqlps에서 호출된 경우에만 지정할 수 있습니다. argument_array는 script_block의 PowerShell 명령에 대한 인수를 포함하는 PowerShell 변수 배열입니다.

• string [ command_parameters ]
  실행할 PowerShell 명령을 포함하는 문자열을 지정합니다. "&{command}" 형식을 사용합니다. 큰따옴표는 문자열을 나타내며 호출 연산자(&)는 sqlps가 명령을 실행하도록 합니다.

• [ -? | -Help ]
  sqlps 옵션의 구문 요약 정보를 표시합니다.

주의

sqlps 유틸리티는 SQL Server PowerShell 스냅인이 로드되고 등록된 PowerShell 환경(PowerShell.exe)을 시작합니다. SQL Server PowerShell 스냅인은 다음과 같습니다.

• Microsoft.SqlServer.Management.PSProvider.dll

  SQL Server PowerShell 공급자 및 Encode-SqlName, Decode-SqlName과 같은 관련 cmdlet을 구현합니다.

• Microsoft.SqlServer.Management.PSSnapin.dll

  Invoke-Sqlcmd cmdlet을 구현합니다.

다음과 같은 작업에 sqlps를 사용할 수 있습니다.

• 대화형으로 PowerShell 명령을 실행합니다.

• PowerShell 스크립트 파일을 실행합니다.

• SQL Server cmdlet을 실행합니다.

• SQL Server 공급자 경로를 사용하여 SQL Server 개체의 계층 구조를 탐색합니다.

기본적으로 sqlps는 스크립팅 실행 정책이 Restricted로 설정된 상태로 실행됩니다. 이는 모든 PowerShell 스크립트의 실행을 차단합니다. Set-ExecutionPolicy cmdlet을 사용하면 서명된 스크립트나 기타 스크립트를 실행하도록 설정할 수 있습니다. 신뢰할 수 있는 출처에서 제공하는 스크립트만 실행하고 적절한 NTFS 권한을 사용하여 모든 입력 및 출력 파일을 보호하십시오. PowerShell 스크립트를 설정하는 방법은 Windows PowerShell 스크립트 실행(Running Windows PowerShell Scripts)을 참조하십시오.

예

1. sqlps를 저작권 배너 없이 기본 대화형 모드로 실행합니다.

sqlps -NoLogo

2. 명령 프롬프트에서 SQL Server PowerShell 스크립트를 실행합니다.

sqlps -Command "&{.\MyFolder.MyScript.ps1}"

3. 명령 프롬프트에서 SQL Server PowerShell 스크립트를 실행하고 스크립트가 완료된 후에도 계속 실행되도록 합니다.

sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"

참고 항목

태스크

관련 자료