SQLPS 모듈 가져오기Import the SQLPS Module

PowerShell에서 SQL ServerSQL Server 를 관리하는 데 권장되는 방법은 sqlps 모듈을 Windows PowerShell 환경으로 가져오는 것입니다.The recommended way to manage SQL ServerSQL Server from PowerShell is to import the sqlps module into a Windows PowerShell environment. 이 모듈은 SQL ServerSQL Server 스냅인 및 관리 효율성 어셈블리를 로드하고 등록합니다.The module loads and registers the SQL ServerSQL Server snap-ins and manageability assemblies. Windows PowerShell 3.0부터 모듈은 명령에서 cmdlet 또는 모듈의 함수를 사용할 경우 자동으로 가져옵니다.Beginning in Windows PowerShell 3.0, modules are imported automatically when any cmdlet or function in the module is used in a command. 이 기능은 PSModulePath 환경 변수의 값에 포함된 디렉터리에서 모든 모듈에 대해 작동합니다.This feature works on any module in a directory that this included in the value of the PSModulePath environment variable. 자세한 내용은 Importing a PowerShell Module(PowerShell 모듈 가져오기)을 참조하세요.For additional information, see Importing a PowerShell Module

  1. Before You Begin: SecurityBefore You Begin: Security

  2. To load the module: Load the sqlps ModuleTo load the module: Load the sqlps Module

시작하기 전 주의 사항Before You Begin

sqlps 모듈을 Windows PowerShell로 가져온 후 다음을 수행할 수 있습니다.After importing the sqlps module into Windows PowerShell, you can then:

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

  • Windows PowerShell 스크립트 파일을 실행합니다.Run Windows 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.

  • Microsoft.SqlServer.Management.Smo 같은 SQL ServerSQL Server 관리 효율성 개체 모델을 사용하여 SQL ServerSQL Server 개체를 관리합니다.Use the SQL ServerSQL Server manageability object models (such as Microsoft.SqlServer.Management.Smo) to manage SQL ServerSQL Server objects.

참고

두 SQL Server cmdlet(Encode-SqlnameDecode-Sqlname)의 이름에 사용되는 동사는 Windows PowerShell에 대해 승인된 동사와 일치하지 않습니다.The verbs used in the names of two SQL Server cmdlets (Encode-Sqlname and Decode-Sqlname) do not match the approved verbs for Windows PowerShell. 이로 인해 작동에는 영향을 주지 않지만 sqlps 모듈을 세션으로 가져올 때 Windows PowerShell에서 경고를 표시합니다.This has no effect on their operation, but Windows PowerShell raises a warning when the sqlps module is imported to a session.

보안 Security

기본적으로 Windows PowerShell은 모든 Windows PowerShell 스크립트 실행을 방지하는 제한됨으로 설정된 스크립팅 실행 정책과 함께 실행됩니다.By default, Windows PowerShell runs with the scripting execution policy set to Restricted, which prevents running any Windows PowerShell scripts. sqlps 모듈을 로드하려면 Set-ExecutionPolicy cmdlet을 사용하여 서명된 스크립트나 모든 스크립트를 실행하도록 설정할 수 있습니다.To load the sqlps module, 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 using the appropriate NTFS permissions. Windows PowerShell 스크립트를 사용하도록 설정하는 방법은 Windows PowerShell 스크립트 실행을 참조하십시오.For more information about enabling Windows PowerShell scripts, see Running Windows PowerShell Scripts.

sqlps 모듈 로드 Load the sqlps Module

Windows PowerShell에서 sqlps 모듈을 로드하려면To load the sqlps module in Windows PowerShell

  1. Set-ExecutionPolicy cmdlet을 사용하여 적절한 스크립트 실행 정책을 설정합니다.Use the Set-ExecutionPolicy cmdlet to set the appropriate script execution policy.

  2. Import-Module cmdlet을 사용하여 sqlps 모듈을 가져옵니다.Use the Import-Module cmdlet to import the sqlps module. Encode-SqlnameDecode-Sqlname 에 대한 경고를 억제하려면 DisableNameChecking매개 변수를 지정합니다.Specify the DisableNameChecking parameter if you want to suppress the warning about Encode-Sqlname and Decode-Sqlname.

예제Example

이 예에서는 이름 확인을 해제한 상태로 sqlps 모듈을 로드합니다.This example loads the sqlps module with name checking turned off.

# Import the SQL Server Module.    
Import-Module Sqlps -DisableNameChecking;

# To check whether the module is installed.
Get-Module -ListAvailable -Name Sqlps;

참고

sqlps 모듈이 경로에 있지 않은 경우 모듈의 위치를 변경하거나 스크립트에서 전체 경로를 사용합니다(경로의 폴더에 큰따옴표를 사용하면 공백이 생김).If the sqlps module is not in your path, change to the location of the module or use the full path in the script (using double-quotes of folders in your path have spaces). sqlps 모듈은 SQL Server 인스턴스에 대한 Tools\Powershell 폴더에 있습니다.The sqlps module is located in the Tools\Powershell folder for your SQL Server instance.

맨 위 링크와 함께 사용되는 화살표 아이콘 [맨 위로 이동]Arrow icon used with Back to Top link [Top]

참고 항목See Also

SQL Server PowerShell SQL Server PowerShell
SQL Server PowerShell 공급자 SQL Server PowerShell Provider
데이터베이스 엔진 cmdlet 사용 Use the Database Engine cmdlets
PowerShell 모듈 설치 Installing a PowerShell Module
Import-Module Import-Module