다음을 통해 공유

sqlps 유틸리티

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

중요합니다

이 기능은 이후 버전의 Microsoft SQL Server에서 제거됩니다. 새 개발 작업에서 이 기능을 사용하지 말고 현재 이 기능을 사용하는 애플리케이션을 수정할 계획입니다. sqlps 대신 PowerShell 모듈을 사용합니다. 모듈에 sqlps 대한 자세한 내용은 SQLPS 모듈 가져오기를 참조하세요.

문법

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

주장들

-NoLogo
유틸리티가 sqlps 시작될 때 저작권 배너를 숨기게 지정합니다.

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

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

-OutPutFormat { Text | XML }
유틸리티 출력의 sqlps 서식을 텍스트 문자열(텍스트) 또는 직렬화된 CLIXML 형식(XML)으로 지정합니다.

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

-명령
실행할 유틸리티에 sqlps 대한 명령을 지정합니다. -NoExit도 지정하지 않으면 유틸리티가 sqlps 명령을 실행한 다음 종료됩니다. -Command뒤에는 다른 스위치를 지정하지 마세요. 이 경우 스위치가 명령 매개 변수로 읽힙니다.

-
-Command- 유틸리티가 sqlps 표준 입력에서 입력을 읽는 것을 지정합니다.

script_block [ -argsargument_array ]
실행할 PowerShell 명령 블록을 지정합니다. 명령 블록은 중괄호 {}로 묶어야 합니다. Script_blockPowerShell 또는 다른 sqlps 유틸리티 세션에서 유틸리티를 sqlps 호출할 때만 지정할 수 있습니다. argument_array 는 script_block의 PowerShell 명령에 대한 인수를 포함하는 PowerShell 변수 배열입니다.

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

[ -? | -도움말 ]
sqlps은 유틸리티 옵션의 구문 요약을 표시합니다.

비고

유틸리티는 sqlps PowerShell 환경(PowerShell.exe)을 시작하고 SQL Server PowerShell 모듈을 로드합니다. 또한 명명된 sqlps모듈은 다음 SQL Server PowerShell 스냅인을 로드하고 등록합니다.

  • Microsoft.SqlServer.Management.PSProvider.dll

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

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Invoke-Sqlcmd 및 Invoke-PolicyEvaluation cmdlet을 구현합니다.

유틸리티를 sqlps 사용하여 다음을 수행할 수 있습니다.

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

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

  • SQL Server cmdlets를 실행합니다.

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

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

SQL Server 2008 및 SQL Server 2008 R2의 유틸리티 버전은 sqlps Windows PowerShell 1.0 미니 셸로 구현되었습니다. 미니 셸에는 사용자가 미니 셸에서 로드하는 스냅인 이외의 스냅인을 로드할 수 없는 것과 같은 몇 가지 제한 사항이 있습니다. SQL Server 2012 및 상위 버전의 유틸리티는 sqlps 모듈을 사용하도록 변경되었으므로 이러한 제한이 적용되지 않습니다.

예시

sqlps -NoLogo

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

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

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

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

또한 참조하십시오

서버 네트워크 프로토콜 설정 또는 해제
SQL Server PowerShell

  • Last updated on