sqlps 유틸리티sqlps Utility

sqlps 유틸리티는 SQL ServerSQL Server PowerShell 공급자와 cmdlet이 로드 및 등록된 Windows PowerShell 세션을 시작합니다.The sqlps utility starts a Windows PowerShell session with the SQL ServerSQL Server PowerShell provider and cmdlets loaded and registered. SQL ServerSQL Server PowerShell 구성 요소를 사용하여 SQL ServerSQL Server 인스턴스 및 해당 개체와 함께 작동하는 PowerShell 명령 또는 스크립트를 입력할 수 있습니다.You can enter PowerShell commands or scripts that use the SQL ServerSQL Server PowerShell components to work with instances of SQL ServerSQL Server and their objects.

중요

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다.This feature will be removed in a future version of Microsoft SQL Server. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하세요.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.사용 하 여 sqlps PowerShell 모듈 대신 합니다. Use the sqlps PowerShell module instead. sqlps 모듈에 대한 자세한 내용은 Import the SQLPS Module를 참조하세요.For more information about the sqlps module, see Import the SQLPS Module.

구문Syntax


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

인수Arguments

-NoLogo-NoLogo
sqlps 유틸리티가 시작될 때 저작권 배너를 표시하지 않도록 지정합니다.Specifies that the sqlps utility hide the copyright banner when it starts.

-NoExit-NoExit
시작 명령이 완료된 후에도 sqlps 유틸리티가 계속 실행되도록 지정합니다.Specifies that the sqlps utility continue running after the startup commands have completed.

-NoProfile-NoProfile
sqlps 유틸리티가 사용자 프로필을 로드하지 않도록 지정합니다.Specifies that the sqlps utility not load a user profile. 사용자 프로필은 PowerShell 세션에서 사용하도록 공통적으로 사용되는 별칭, 함수 및 변수를 기록합니다.User profiles record commonly used aliases, functions, and variables for use across PowerShell sessions.

-OutPutFormat { Text | XML }-OutPutFormat { Text | XML }
sqlps 유틸리티 출력 형식이 텍스트 문자열(Text) 또는 직렬화된 CLIXML 형식(XML)이 되도록 지정합니다.Specifies that the sqlps utility output be formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-InPutFormat { Text | XML }-InPutFormat { Text | XML }
sqlps 유틸리티에 대한 입력 형식이 텍스트 문자열(Text) 또는 직렬화된 CLIXML 형식(XML)이 되도록 지정합니다.Specifies that input to the sqlps utility is formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-Command-Command
sqlps 유틸리티에 대한 명령이 실행되도록 지정합니다.Specifies the command for the sqlps utility to run. sqlps 유틸리티는 -NoExit 가 지정되지 않은 경우 명령을 실행한 다음 종료됩니다.The sqlps utility runs the command and then exits, unless -NoExit is also specified. -Command뒤에는 다른 스위치를 지정하지 마세요. 이 경우 스위치가 명령 매개 변수로 읽힙니다.Do not specify any other switches after -Command, they will be read as command parameters.


-Command-sqlps 유틸리티가 표준 입력으로부터 입력을 읽도록 지정합니다.-Command- specifies that the sqlps utility read the input from the standard input.

script_block [ -argsargument_array ]script_block [ -argsargument_array ]
실행할 PowerShell 명령 블록을 지정합니다. 명령 블록은 중괄호 {}로 묶어야 합니다.Specifies a block of PowerShell commands to run, the block must be enclosed in braces: {}. Script_blocksqlps 유틸리티가 PowerShell 또는 다른 sqlps 유틸리티 세션에서 호출된 경우에만 지정할 수 있습니다.Script_block can only be specified when the sqlps utility is called from either PowerShell or another sqlps utility session. argument_arrayscript_block의 PowerShell 명령에 대한 인수를 포함하는 PowerShell 변수 배열입니다.The argument_array is an array of PowerShell variables containing the arguments for the PowerShell commands in the script_block.

string [ command_parameters ]string [ command_parameters ]
실행할 PowerShell 명령을 포함하는 문자열을 지정합니다.Specifies a string that contains the PowerShell commands to be run. "&{command}" 형식을 사용합니다.Use the format "&{command}". 큰따옴표는 문자열을 나타내며 호출 연산자(&)는 sqlps 유틸리티가 명령을 실행하도록 합니다.The quotation marks indicate a string, and the invoke operator (&) causes the sqlps utility to run the command.

[ -?[ -? | -Help ] | -Help ]
sqlps 유틸리티 옵션의 구문 요약 정보를 표시합니다.Shows the syntax summary of the sqlps utility options.

주의Remarks

sqlps 유틸리티는 PowerShell 환경(PowerShell.exe)을 시작하고 SQL ServerSQL Server PowerShell 모듈을 로드합니다.The sqlps utility starts the PowerShell environment (PowerShell.exe) and loads the SQL ServerSQL Server PowerShell module. sqlps라고도 하는 이 모듈은 다음 SQL ServerSQL Server PowerShell 스냅인을 로드하고 등록합니다.The module, also named sqlps, loads and registers these SQL ServerSQL Server PowerShell snap-ins:

  • Microsoft.SqlServer.Management.PSProvider.dllMicrosoft.SqlServer.Management.PSProvider.dll

    SQL ServerSQL Server PowerShell 공급자 및 Encode-SqlName , Decode-SqlName과 같은 관련 cmdlet을 구현합니다.Implements the SQL ServerSQL Server PowerShell provider and associated cmdlets such as Encode-SqlName and Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dllMicrosoft.SqlServer.Management.PSSnapin.dll

    Invoke-SqlcmdInvoke-PolicyEvaluation cmdlet을 구현합니다.Implements the Invoke-Sqlcmd and Invoke-PolicyEvaluation cmdlets.

    다음과 같은 작업에 sqlps 유틸리티를 사용할 수 있습니다.You can use the sqlps utility to do the following:

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

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

  • SQL ServerSQL Server cmdlet을 실행합니다.Run SQL ServerSQL Server cmdlets.

  • SQL ServerSQL Server 공급자 경로를 사용하여 SQL ServerSQL Server 개체의 계층 구조를 탐색합니다.Use the SQL ServerSQL Server provider paths to navigate through the hierarchy of SQL ServerSQL Server objects.

    기본적으로 sqlps 유틸리티는 스크립팅 실행 정책이 Restricted로 설정된 상태로 실행됩니다.By default, the sqlps utility runs with the scripting execution policy set to Restricted. 이는 모든 PowerShell 스크립트의 실행을 차단합니다.This prevents running any PowerShell scripts. Set-ExecutionPolicy cmdlet을 사용하면 서명된 스크립트나 모든 스크립트를 실행하도록 설정할 수 있습니다.You can use the Set-ExecutionPolicy cmdlet to enable running signed scripts, or any scripts. 신뢰할 수 있는 출처에서 제공하는 스크립트만 실행하고 적절한 NTFS 권한을 사용하여 모든 입력 및 출력 파일을 보호하십시오.Only run scripts from trusted sources, and secure all input and output files by using the appropriate NTFS permissions. PowerShell 스크립트를 설정하는 방법은 Windows PowerShell 스크립트 실행을 참조하십시오.For more information about enabling PowerShell scripts, see Running Windows PowerShell Scripts.

    SQL Server 2008SQL Server 2008 sqlps SQL Server 2008 R2SQL Server 2008 R2 유틸리티 버전은 Windows PowerShell 1.0 미니 셸로 구현되었습니다.The version of the sqlps utility in SQL Server 2008SQL Server 2008 and SQL Server 2008 R2SQL Server 2008 R2 was implemented as a Windows PowerShell 1.0 mini-shell. 미니 셸에는 사용자가 미니 셸에서 로드하는 스냅인 이외의 스냅인을 로드할 수 없는 것과 같은 몇 가지 제한 사항이 있습니다.Mini-shells have certain restrictions, such as not allowing users to load snap-ins other than those loaded by the mini-shell. 이러한 제한 사항은 SQL Server 2012SQL Server 2012 모듈을 사용하도록 변경된 sqlps 이상 버전의 유틸리티에는 적용되지 않습니다.These restrictions do not apply to the SQL Server 2012SQL Server 2012 and higher versions of the utility, which have been changed to use the sqlps module.

Examples

A. Sqlps 유틸리티를 기본, 저작권 배너 없이 대화형 모드를 실행 합니다.A. Run the sqlps utility in default, interactive mode without the copyright banner

sqlps -NoLogo  

B. 명령 프롬프트에서 SQL Server PowerShell 스크립트를 실행 합니다.B. Run a SQL Server PowerShell script from the command prompt

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

C. 명령 프롬프트에서 SQL Server PowerShell 스크립트를 실행 하 고 스크립트가 완료 된 후 계속 실행C. Run a SQL Server PowerShell script from the command prompt, and keep running after the script completes

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

참고 항목See Also

서버 네트워크 프로토콜 설정 또는 해제 Enable or Disable a Server Network Protocol
SQL Server PowerShellSQL Server PowerShell