다음을 통해 공유


sqlps 유틸리티

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

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

Important

SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 sqlps PowerShell 모듈을 사용하세요. sqlps 모듈에 대한 자세한 내용은 Import the SQLPS Module를 참조하세요.

구문

  
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_blocksqlps 유틸리티가 PowerShell 또는 다른 sqlps 유틸리티 세션에서 호출된 경우에만 지정할 수 있습니다. argument_arrayscript_block의 PowerShell 명령에 대한 인수를 포함하는 PowerShell 변수 배열입니다.

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

[ -? | -Help ]
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-SqlcmdInvoke-PolicyEvaluation cmdlet을 구현합니다.

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

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

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

  • SQL Server cmdlets를 실행합니다.

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

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

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

A. 저작권 배너를 표시하지 않고 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