다음을 통해 공유


sqlps 유틸리티

sqlps 유틸리티는 SQL Server PowerShell 공급자와 cmdlet이 로드 및 등록된 PowerShell 세션을 시작합니다. SQL Server PowerShell 구성 요소를 사용하여 SQL Server 인스턴스 및 해당 개체와 함께 작동하는 PowerShell 명령 또는 스크립트를 입력할 수 있습니다.

구문

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은 sqlpsPowerShell 또는 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}"