{"id":395053,"date":"2024-12-18T13:02:32","date_gmt":"2024-12-18T13:02:32","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=395053"},"modified":"2024-12-18T13:02:32","modified_gmt":"2024-12-18T13:02:32","slug":"abrufen-von-mssql-server-instanzen","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/de\/script-hub\/abrufen-von-mssql-server-instanzen\/","title":{"rendered":"Wie man PowerShell verwendet, um SQL-Server-Instanzen zu entdecken und dokumentieren"},"content":{"rendered":"

M\u00f6chten Sie lernen, wie man <\/strong>MSSQL-Server-Instanzen mit PowerShell abrufen kann<\/strong>? <\/span>In der IT-Welt ist die Verwaltung und Wartung von SQL-Server-Instanzen<\/a> eine wichtige Aufgabe f\u00fcr IT-Expert:innen und Managed Service Provider (MSPs)<\/a>. Wenn Sie wissen, wie Sie effizient Informationen \u00fcber SQL Server-Instanzen sammeln, k\u00f6nnen Sie Ihre administrativen Aufgaben erheblich verbessern und Prozesse rationalisieren. Dieser Blogbeitrag befasst sich mit einem leistungsstarken PowerShell-Skript zum Abrufen einer Liste von MSSQL-Server-Instanzen und bietet detaillierte Einblicke und praktische Anwendungen.<\/p>\n

Kontext<\/h2>\n

SQL-Server-Instanzen sind das R\u00fcckgrat vieler Gesch\u00e4ftsanwendungen und speichern bzw. verwalten gro\u00dfe Datenmengen. IT-Expert:innen m\u00fcssen diese Instanzen oft identifizieren und verwalten, um optimale Leistung und Sicherheit zu gew\u00e4hrleisten. Das mitgelieferte PowerShell-Skript ist ein unsch\u00e4tzbares Tool zum schnellen Abrufen von Informationen \u00fcber SQL Server-Instanzen auf einem System. Diese F\u00e4higkeit ist f\u00fcr Aufgaben wie Pr\u00fcfungen, Fehlersuche und System\u00fcberwachung von entscheidender Bedeutung.<\/p>\n

Das Skript zum Abrufen von MSSQL Server-Instanzen<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Gets a list of MSSQL server instances and optionally save the results to a custom field.\r\n.DESCRIPTION\r\n    Gets a list of MSSQL server instances and optionally save the results to a custom field.\r\n    The custom field can be either\/both a multi-line or WYSIWYG custom field.\r\n\r\n    SQL Server, SQL Server Developer and SQL Express are supported.\r\n\r\n    SQL \"Local\" that are built into an application are not supported as they aren't an SQL Server instance.\r\n\r\n    SQL service name that don't start with \"MSSQL$\" will not get detected.\r\n\r\n    PS > Get-Service -Name \"MSSQL`$*\"\r\n    Status   Name               DisplayName\r\n    ------   ----               -----------\r\n    Running  MSSQL$DB           SQL Server (DB)\r\n    Running  MSSQL$DB01         SQL Server (DB01)\r\n    Running  MSSQL$DB02         SQL Server (DB02)\r\n\r\n.EXAMPLE\r\n    (No Parameters)\r\n    ## EXAMPLE OUTPUT WITHOUT PARAMS ##\r\n     Status Name              Instance Path\r\n     ------ ----              -------- ----\r\n    Running SQL Server (DB01) DB01     C:\\Program Files\\Microsoft SQL Server\\MSSQL16.DB01\\MSSQL\r\n    Running SQL Server (DB02) DB02     C:\\Program Files\\Microsoft SQL Server\\MSSQL16.DB02\\MSSQL\r\n\r\nPARAMETER: -CustomFieldName \"ReplaceMeWithAnyMultilineCustomField\"\r\n    Saves an text table to a multi-line Custom Field with a list of SQL instances.\r\n.EXAMPLE\r\n    -CustomFieldName \"ReplaceMeWithAnyMultilineCustomField\"\r\n    ## EXAMPLE OUTPUT WITH CustomFieldName ##\r\n     Status Name              Instance Path\r\n     ------ ----              -------- ----\r\n    Running SQL Server (DB01) DB01     C:\\Program Files\\Microsoft SQL Server\\MSSQL16.DB01\\MSSQL\r\n    Running SQL Server (DB02) DB02     C:\\Program Files\\Microsoft SQL Server\\MSSQL16.DB02\\MSSQL\r\n\r\nPARAMETER: -CustomFieldParam \"ReplaceMeWithAnyWysiwygCustomField\"\r\n    Saves an html table to a Wysiwyg Custom Field with a list of SQL instances.\r\n.EXAMPLE\r\n    -WysiwygCustomFieldName \"ReplaceMeWithAnyWysiwygCustomField\"\r\n    ## EXAMPLE OUTPUT WITH WysiwygCustomFieldName ##\r\n     Status Name              Instance Path\r\n     ------ ----              -------- ----\r\n    Running SQL Server (DB01) DB01     C:\\Program Files\\Microsoft SQL Server\\MSSQL16.DB01\\MSSQL\r\n    Running SQL Server (DB02) DB02     C:\\Program Files\\Microsoft SQL Server\\MSSQL16.DB02\\MSSQL\r\n.OUTPUTS\r\n    None\r\n.NOTES\r\n    Release Notes: Initial Release\r\nBy using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https:\/\/www.ninjaone.com\/terms-of-use.\r\n    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. \r\n    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. \r\n    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. \r\n    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. \r\n    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [String]$CustomFieldName,\r\n    [String]$WysiwygCustomFieldName\r\n)\r\n\r\nbegin {\r\n    function Test-IsElevated {\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n        $p = New-Object System.Security.Principal.WindowsPrincipal($id)\r\n        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)\r\n    }\r\n    function Set-NinjaProperty {\r\n        [CmdletBinding()]\r\n        Param(\r\n            [Parameter(Mandatory = $True)]\r\n            [String]$Name,\r\n            [Parameter()]\r\n            [String]$Type,\r\n            [Parameter(Mandatory = $True, ValueFromPipeline = $True)]\r\n            $Value,\r\n            [Parameter()]\r\n            [String]$DocumentName\r\n        )\r\n    \r\n        $Characters = $Value | Measure-Object -Character | Select-Object -ExpandProperty Characters\r\n        if ($Characters -ge 10000) {\r\n            throw [System.ArgumentOutOfRangeException]::New(\"Character limit exceeded, value is greater than 10,000 characters.\")\r\n        }\r\n        \r\n        # If we're requested to set the field value for a Ninja document we'll specify it here.\r\n        $DocumentationParams = @{}\r\n        if ($DocumentName) { $DocumentationParams[\"DocumentName\"] = $DocumentName }\r\n        \r\n        # This is a list of valid fields that can be set. If no type is given, it will be assumed that the input doesn't need to be changed.\r\n        $ValidFields = \"Attachment\", \"Checkbox\", \"Date\", \"Date or Date Time\", \"Decimal\", \"Dropdown\", \"Email\", \"Integer\", \"IP Address\", \"MultiLine\", \"MultiSelect\", \"Phone\", \"Secure\", \"Text\", \"Time\", \"URL\", \"WYSIWYG\"\r\n        if ($Type -and $ValidFields -notcontains $Type) { Write-Warning \"$Type is an invalid type! Please check here for valid types. https:\/\/ninjarmm.zendesk.com\/hc\/en-us\/articles\/16973443979789-Command-Line-Interface-CLI-Supported-Fields-and-Functionality\" }\r\n        \r\n        # The field below requires additional information to be set\r\n        $NeedsOptions = \"Dropdown\"\r\n        if ($DocumentName) {\r\n            if ($NeedsOptions -contains $Type) {\r\n                # We'll redirect the error output to the success stream to make it easier to error out if nothing was found or something else went wrong.\r\n                $NinjaPropertyOptions = Ninja-Property-Docs-Options -AttributeName $Name @DocumentationParams 2>&1\r\n            }\r\n        }\r\n        else {\r\n            if ($NeedsOptions -contains $Type) {\r\n                $NinjaPropertyOptions = Ninja-Property-Options -Name $Name 2>&1\r\n            }\r\n        }\r\n        \r\n        # If an error is received it will have an exception property, the function will exit with that error information.\r\n        if ($NinjaPropertyOptions.Exception) { throw $NinjaPropertyOptions }\r\n        \r\n        # The below type's require values not typically given in order to be set. The below code will convert whatever we're given into a format ninjarmm-cli supports.\r\n        switch ($Type) {\r\n            \"Checkbox\" {\r\n                # While it's highly likely we were given a value like \"True\" or a boolean datatype it's better to be safe than sorry.\r\n                $NinjaValue = [System.Convert]::ToBoolean($Value)\r\n            }\r\n            \"Date or Date Time\" {\r\n                # Ninjarmm-cli expects the GUID of the option to be selected. Therefore, the given value will be matched with a GUID.\r\n                $Date = (Get-Date $Value).ToUniversalTime()\r\n                $TimeSpan = New-TimeSpan (Get-Date \"1970-01-01 00:00:00\") $Date\r\n                $NinjaValue = $TimeSpan.TotalSeconds\r\n            }\r\n            \"Dropdown\" {\r\n                # Ninjarmm-cli is expecting the guid of the option we're trying to select. So we'll match up the value we were given with a guid.\r\n                $Options = $NinjaPropertyOptions -replace '=', ',' | ConvertFrom-Csv -Header \"GUID\", \"Name\"\r\n                $Selection = $Options | Where-Object { $_.Name -eq $Value } | Select-Object -ExpandProperty GUID\r\n        \r\n                if (-not $Selection) {\r\n                    throw [System.ArgumentOutOfRangeException]::New(\"Value is not present in dropdown\")\r\n                }\r\n        \r\n                $NinjaValue = $Selection\r\n            }\r\n            default {\r\n                # All the other types shouldn't require additional work on the input.\r\n                $NinjaValue = $Value\r\n            }\r\n        }\r\n        \r\n        # We'll need to set the field differently depending on if its a field in a Ninja Document or not.\r\n        if ($DocumentName) {\r\n            $CustomField = Ninja-Property-Docs-Set -AttributeName $Name -AttributeValue $NinjaValue @DocumentationParams 2>&1\r\n        }\r\n        else {\r\n            $CustomField = Ninja-Property-Set -Name $Name -Value $NinjaValue 2>&1\r\n        }\r\n        \r\n        if ($CustomField.Exception) {\r\n            throw $CustomField\r\n        }\r\n    }\r\n    if ($env:multilineCustomFieldName -and $env:multilineCustomFieldName -notlike \"null\") {\r\n        $CustomFieldName = $env:multilineCustomFieldName\r\n    }\r\n    if ($env:WysiwygCustomFieldName -and $env:WysiwygCustomFieldName -notlike \"null\") {\r\n        $WysiwygCustomFieldName = $env:WysiwygCustomFieldName\r\n    }\r\n}\r\nprocess {\r\n    if (-not (Test-IsElevated)) {\r\n        Write-Error -Message \"Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    try {\r\n        $InstanceNames = $(Get-ItemProperty -Path \"HKLM:\\SOFTWARE\\Microsoft\\Microsoft SQL Server\\\" -ErrorAction Stop).InstalledInstances\r\n        $SqlInstances = $InstanceNames | ForEach-Object {\r\n            $SqlPath = $(Get-ItemProperty -Path \"HKLM:\\SOFTWARE\\Microsoft\\Microsoft SQL Server\\$_\\Setup\" -ErrorAction Stop).SQLPath\r\n            $SqlServices = Get-Service -Name \"MSSQL`$$_\" -ErrorAction Stop\r\n            $SqlService = $SqlServices | Where-Object { $_.Name -notlike $SqlServices.DependentServices.Name -and $_.Name -notlike \"SQLTelemetry*\" }\r\n            [PSCustomObject]@{\r\n                Status   = $SqlService.Status\r\n                Service  = $SqlService.DisplayName\r\n                Instance = $_\r\n                Path     = $SqlPath\r\n            }\r\n        }\r\n    }\r\n    catch {\r\n        Write-Host \"[Error] $($_.Message)\"\r\n        Write-Host \"[Info] Likely no MSSQL instance found.\"\r\n        exit 1\r\n    }\r\n\r\n    $SqlInstances | Out-String | Write-Host\r\n\r\n    if ($CustomFieldName) {\r\n        Write-Host \"Attempting to set Custom Field '$CustomFieldName'.\"\r\n        Set-NinjaProperty -Name $CustomFieldName -Value ($SqlInstances | Out-String)\r\n        Write-Host \"Successfully set Custom Field '$CustomFieldName'!\"\r\n    }\r\n\r\n    if ($WysiwygCustomFieldName) {\r\n        try {\r\n            Write-Host \"Attempting to set Custom Field '$WysiwygCustomFieldName'.\"\r\n            $htmlReport = New-Object System.Collections.Generic.List[String]\r\n            $htmlReport.Add(\"<h1>SQL Server Instances<\/h1>\")\r\n            $htmlTable = $SqlInstances | ConvertTo-Html -Fragment \r\n            $htmlTable = $htmlTable -replace \"<tr><td>Running<\/td>\", '<tr class=\"success\"><td>Running<\/td>'\r\n            $htmlTable = $htmlTable -replace \"<tr><td>StartPending<\/td>\", '<tr class=\"other\"><td>StartPending<\/td>'\r\n            $htmlTable = $htmlTable -replace \"<tr><td>ContinuePending<\/td>\", '<tr class=\"other\"><td>ContinuePending<\/td>'\r\n            $htmlTable = $htmlTable -replace \"<tr><td>Paused<\/td>\", '<tr class=\"other\"><td>Paused<\/td>'\r\n            $htmlTable = $htmlTable -replace \"<tr><td>PausePending<\/td>\", '<tr class=\"other\"><td>PausePending<\/td>'\r\n            $htmlTable = $htmlTable -replace \"<tr><td>Stopped<\/td>\", '<tr class=\"danger\"><td>Stopped<\/td>'\r\n            $htmlTable = $htmlTable -replace \"<tr><td>StopPending<\/td>\", '<tr class=\"danger\"><td>StopPending<\/td>'\r\n            $htmlTable | ForEach-Object { $htmlReport.Add($_) }\r\n            Set-NinjaProperty -Name $WysiwygCustomFieldName -Value ($htmlReport | Out-String)\r\n            Write-Host \"Successfully set Custom Field '$WysiwygCustomFieldName'!\"\r\n        }\r\n        catch {\r\n            Write-Error $_\r\n            Write-Host \"[Error] $($_.Message)\"\r\n            exit 1\r\n        }\r\n    }\r\n    exit 0\r\n}\r\nend {\r\n    \r\n    \r\n    \r\n}<\/pre>\n
 <\/p>\n\n
Greifen Sie auf \u00fcber 300 Skripte im NinjaOne Dojo zu.<\/p>\n
Zugang erhalten<\/a><\/p>\n<\/div>\n
Detailansicht<\/h2>\n
Das Skript pr\u00fcft zun\u00e4chst, ob es mit Administratorrechten ausgef\u00fchrt wird, die f\u00fcr den Zugriff auf bestimmte Systemeigenschaften erforderlich sind. Sie definiert eine Funktion, Test-IsElevated, um dies zu \u00fcberpr\u00fcfen. Wenn das Skript nicht als Administrator ausgef\u00fchrt wird, wird es mit einem Fehlermeldung beendet.<\/p>\n
Anschlie\u00dfend wird versucht, die installierten SQL-Server-Instanzen aus der Windows-Registrierung<\/a> abzurufen. Dies wird durch das Cmdlet ‚Get-ItemProperty‘ erreicht, das auf den entsprechenden Registrierungspfad zugreift. Das Skript durchl\u00e4uft dann jede Instanz und ruft Details wie den Instanznamen, den Dienststatus und den Installationspfad ab.<\/p>\n
Die gesammelten Informationen werden in einem benutzerdefinierten Objekt strukturiert und angezeigt. Falls angegeben, k\u00f6nnen die Ergebnisse auch in benutzerdefinierten Feldern gespeichert werden, entweder als Plain-Text oder als HTML, unter Verwendung der Funktion Set-NinjaProperty. Diese Funktion verarbeitet verschiedene Datentypen und stellt sicher, dass die Werte den Zeichengrenzen und anderen Beschr\u00e4nkungen entsprechen.<\/p>\n
Potenzielle Anwendungsf\u00e4lle<\/h2>\n
Stellen Sie sich vor, ein IT-Experte verwaltet mehrere Server in einem Unternehmen. Mit diesem Skript kann er alle SQL-Server-Instanzen, die auf den einzelnen Servern laufen, schnell erfassen und dokumentieren. Diese Informationen sind f\u00fcr Software-Updates, die Durchf\u00fchrung von Sicherheitsaudits und die Kapazit\u00e4tsplanung unerl\u00e4sslich. W\u00e4hrend eines Upgrade-Zyklus beispielsweise hilft die Kenntnis aller aktiven Instanzen bei der Planung und Minimierung von Ausfallzeiten.<\/p>\n
Vergleiche<\/h2>\n
Dieses PowerShell-Skript bietet eine optimierte und automatisierte Methode zum Erfassen von SQL-Server-Instanzinformationen im Vergleich zu manuellen Methoden. Traditionell k\u00f6nnen Administrator:innen das SQL Server Management Studio (SSMS) verwenden oder die Dienste manuell \u00fcber die Windows Services-Konsole \u00fcberpr\u00fcfen. Diese Methoden sind zwar wirksam, aber zeitaufw\u00e4ndig und anf\u00e4llig f\u00fcr menschliches Versagen<\/a>. Im Gegensatz dazu bietet das Skript einen konsistenten, wiederholbaren Prozess, der leicht in umfassendere IT-Management-Workflows integriert werden kann.<\/p>\n
FAQs<\/h2>\n
F: Kann dieses Skript SQL-Server-Instanzen erkennen, die als Teil einer Anwendung installiert sind?<\/h3>\n
A: Nein, das Skript ist so konzipiert, dass es Standard-SQL-Server-Instanzen erkennt. Instanzen, die in Anwendungen eingebettet sind, werden nicht unterst\u00fctzt.<\/p>\n
F: Was passiert, wenn der Name eines benutzerdefinierten Feldes die Zeichengrenze \u00fcberschreitet?<\/h3>\n
A: Das Skript enth\u00e4lt eine Pr\u00fcfung, um sicherzustellen, dass die Werte nicht mehr als 10.000 Zeichen umfassen. Wird diese Grenze \u00fcberschritten, tritt ein Fehler auf.<\/p>\n
F: Kann dieses Skript auf jeder Version von PowerShell ausgef\u00fchrt werden?<\/h3>\n
A: Das Skript erfordert PowerShell Version 5.1 oder h\u00f6her.<\/p>\n
Folgen<\/h2>\n
Durch die Ausf\u00fchrung dieses Skripts erhalten IT-Expert:innen einen detaillierten Einblick in die SQL-Server-Bereitstellung in ihrer Infrastruktur. Diese Informationen sind wichtig, um die Compliance zu gew\u00e4hrleisten, die Leistung zu optimieren und die Sicherheit zu erh\u00f6hen. Wenn Administrator:innen genau wissen, wo SQL-Server-Instanzen ausgef\u00fchrt werden, k\u00f6nnen sie sensible Daten besser sch\u00fctzen und sicherstellen, dass die Systeme richtig konfiguriert und gewartet werden.<\/p>\n
Empfehlungen<\/h2>\n