Delen via

sqlps-hulpprogramma

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Database in Microsoft Fabric

Het sqlps-hulpprogramma start een Windows PowerShell-sessie met de SQL Server PowerShell-provider en cmdlets die zijn geladen en geregistreerd. U kunt PowerShell-opdrachten of -scripts invoeren die gebruikmaken van de SQL Server PowerShell-onderdelen om te werken met exemplaren van SQL Server en hun objecten.

Belangrijk

Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. Gebruik in plaats daarvan de PowerShell-module sqlps . Zie De SQLPS-module importeren voor meer informatie over de SQLPS-module.

Syntaxis

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

Argumenten

Hiermee geeft u op dat het hulpprogramma sqlps de copyrightbanner verbergt wanneer deze wordt gestart.

-NoExit

Hiermee geeft u op dat het sqlps-hulpprogramma blijft worden uitgevoerd nadat de opstartopdrachten zijn voltooid.

-NoProfile

Hiermee geeft u op dat het sqlps-hulpprogramma geen gebruikersprofiel laadt. Gebruikersprofielen registreren veelgebruikte aliassen, functies en variabelen voor gebruik in PowerShell-sessies.

-OutPutFormat { Text | XML }

Hiermee geeft u op dat de uitvoer van het hulpprogramma sqlps is opgemaakt als teksttekenreeksen (Tekst) of in een geserialiseerde CLIXML-indeling (XML).

-InPutFormat { Text | XML }

Hiermee geeft u op dat invoer voor het hulpprogramma sqlps is opgemaakt als teksttekenreeksen (tekst) of in een geserialiseerde CLIXML-indeling (XML).

-Bevelen

Hiermee geeft u de opdracht voor het sqlps-hulpprogramma uit te voeren. Het sqlps-hulpprogramma voert de opdracht uit en sluit vervolgens af, tenzij -NoExit dit ook is opgegeven. Geef daarna geen andere schakelopties -Commandop. Ze worden gelezen als opdrachtparameters.

-

-Command- geeft aan dat het hulpprogramma sqlps de invoer van de standaardinvoer leest.

script_block [ -argsargument_array ]

Hiervoor specificeert u een blok van PowerShell-opdrachten om uit te voeren, en het blok moet tussen accolades staan: {}. Script_block kan alleen worden opgegeven wanneer het sqlps-hulpprogramma wordt aangeroepen vanuit PowerShell of een andere sqlps-hulpprogrammasessie . De argument_array is een matrix van PowerShell-variabelen met de argumenten voor de PowerShell-opdrachten in de script_block.

tekenreeks [ command_parameters ]

Hiermee geeft u een tekenreeks op die de PowerShell-opdrachten bevat die moeten worden uitgevoerd. Gebruik de indeling "{<command>}". De aanhalingstekens geven een tekenreeks aan en de aanroepoperator (&) zorgt ervoor dat het sqlps-hulpprogramma de opdracht (<command>) uitvoert.

[ -? | -Hulp ]

Toont de syntaxissamenvatting van de sqlps-hulpprogrammaopties .

Opmerkingen

Het sqlps-hulpprogramma start de PowerShell-omgeving (PowerShell.exe) en laadt de SQL Server PowerShell-module. De module, ook wel sqlps genoemd, laadt en registreert deze SQL Server PowerShell-modules:

  • Microsoft.SqlServer.Management.PSProvider.dll

    Implementeert de SQL Server PowerShell-provider en bijbehorende cmdlets, zoals Encode-SqlName en Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Implementeert de cmdlets Invoke-Sqlcmd en Invoke-PolicyEvaluation .

U kunt het hulpprogramma sqlps gebruiken om de volgende taken uit te voeren:

  • Voer Interactief PowerShell-opdrachten uit.

  • Voer PowerShell-scriptbestanden uit.

  • Voer SQL Server-cmdlets uit.

  • Gebruik de paden van de SQL Server-provider om door de hiërarchie van SQL Server-objecten te navigeren.

Het sqlps-hulpprogramma wordt standaard uitgevoerd met het uitvoeringsbeleid voor scripts dat is ingesteld op Beperkt. Dit voorkomt het uitvoeren van PowerShell-scripts. U kunt de cmdlet Set-ExecutionPolicy gebruiken om het uitvoeren van ondertekende scripts of om het uitvoeren van eender welke scripts mogelijk te maken. Voer alleen scripts uit van vertrouwde bronnen en beveilig alle invoer- en uitvoerbestanden met behulp van de juiste NTFS-machtigingen. Zie Windows PowerShell-scripts uitvoeren voor meer informatie over het inschakelen van PowerShell-scripts.

De versie van het sqlps-hulpprogramma in SQL Server 2008 (10.0.x) en SQL Server 2008 R2 (10.50.x) is geïmplementeerd als een Windows PowerShell 1.0 mini-shell. Mini-shells hebben bepaalde beperkingen, zoals het niet toestaan dat gebruikers andere modules laden dan die modules die door de mini-shell zijn geladen. Deze beperkingen zijn niet van toepassing op sql Server 2012 (11.x) en latere versies van het hulpprogramma, die zijn gewijzigd om de sqlps-module te gebruiken.

Voorbeelden

sqlps -NoLogo

B. Een SQL Server PowerShell-script uitvoeren vanaf de opdrachtprompt

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

C. Voer een SQL Server PowerShell-script uit vanaf de opdrachtprompt en blijf actief nadat het script is voltooid

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

Verwante inhoud

  • Last updated on