Share via


SQLps yardımcı programı

The sqlps utility starts a PowerShell session with the SQL Server PowerShell provider and cmdlets loaded and registered.PowerShell komutlarını kullanan veya komut dosyaları girin SQL Server örneklerini birlikte çalışmak için PowerShell bileşenleri SQL Server ve kendi nesneleri.

Sözdizimi

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

Bağımsız değişkenler

  • -NoLogo
    Belirleyen bir sqlps başlatıldığında telif hakkı başlığını gizleyebilirsiniz.

  • -NoExit
    Belirleyen bir sqlps başlangıç komutları tamamladıktan sonra çalıştırmaya devam edin.

  • -NoProfile
    Belirleyen bir sqlps bir kullanıcı profili yüklemeyecek.Kullanıcı kaydı yaygın olarak kullanılan diğer adlar, işlevleri ve değişkenleri kullanmak için PowerShell oturumlarında profilleri.

  • -OutPutFormat { metin | XML }
    Belirleyen bir sqlps çıktı ya da metin dizeleri biçimlendirilmiş olmalıdır (metin) veya seri hale getirilmiş CLIXML biçiminde (xml).

  • -InPutFormat { metin | XML }
    Sqlps giriş ya da metin dizeleri olarak biçimlendirildiğini belirtir (metin) veya seri hale getirilmiş CLIXML biçiminde (xml).

  • -Komut
    Komutunu belirtir sqlps çalıştırmak için.The sqlps utility runs the command and then exits, unless -NoExit is also specified.Sonra diğer bir anahtarlar belirtmek -komut, komut parametreleri okunacak.

  • -
    -Command- specifies that sqlps read the input from the standard input.

  • script_block [ -argsargument_array ]
    PowerShell bloğu çalıştırmak için kullanılan komutlar, blok ayraç içine alınması belirtir: {}.Script_blockne zaman yalnızca belirtilebilir sqlps ya da denilen PowerShell veya sqlps.The argument_array is an array of PowerShell variables containing the arguments for the PowerShell commands in the script_block.

  • string [ command_parameters ]
    Çalıştırılacak PowerShell komutları içeren bir dize belirtir.Use the format "&{command}".Tırnak işaretleri dize ve Invoke işleç gösterir (&) neden olan sqlps komutu çalıştırmak için.

  • [ -? | -Help
    Sözdizimi özetini gösterir sqlps seçenekleri.

Açıklamalar

The sqlps utility starts the PowerShell environment (PowerShell.exe) with the SQL Server PowerShell snap-ins loaded and registered.The SQL Server PowerShell snap-ins are as follows:

  • Microsoft.sqlserver.Management.PSProvider.dll

    Implements SQL Server PowerShell sağlayıcı ve ilişkilendirilmiş cmdlet'leri gibi Kodla SqlName ve SqlName kod çözme.

  • Microsoft.sqlserver.Management.PSSnapin.dll

    Implements Invoke sqlcmd cmdlet.

Kullanabileceğiniz sqlps için aşağıdakilerden birini yapın:

  • Etkileşimli olarak PowerShell komutları çalıştırın.

  • PowerShell komut dosyalarını çalıştırın.

  • Çalıştır SQL Server cmdlet.

  • Use SQL Server Sağlayıcı yollara hiyerarşisi aracılığıyla gezinmek SQL Server nesneler.

Varsayılan olarak, sqlps komut dosyası kullanan kullanan kullanan dosyası yürütme ilkesi ile çalışan küme için Yasak.Bu, herhangi bir PowerShell komut dosyası çalıştırmak engeller.Kullanabileceğiniz Set-executionpolicy imzalı komut dosyaları veya tüm komut dosyalarını etkinleştirmek için cmdlet.Yalnızca güvenilir kaynaklardan gelen komut dosyalarını çalıştırın ve tüm giriş güvenli ve uygun ntfs izinlerini kullanarak dosyaları çıktı.PowerShell komut dosyalarını etkinleştirme hakkında daha fazla bilgi için bkz: Windows PowerShell komut dosyalarını çalıştırma.

Örnekler

A.Run sqlps in default, interactive mode without the copyright banner

sqlps -NoLogo

B.Run a SQL Server PowerShell script from the command prompt

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

C.Run a SQL Server PowerShell script from the command prompt, and keep running after the script completes

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