{"id":533524,"date":"2025-09-29T11:21:00","date_gmt":"2025-09-29T11:21:00","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=533524"},"modified":"2025-09-29T11:21:00","modified_gmt":"2025-09-29T11:21:00","slug":"obtenir-les-details-de-connexion-et-de-session-iscsi-avec-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/obtenir-les-details-de-connexion-et-de-session-iscsi-avec-powershell\/","title":{"rendered":"Comment obtenir les d\u00e9tails de connexion et de session iSCSI avec PowerShell"},"content":{"rendered":"

Dans les environnements de grande entreprise, l’infrastructure de stockage joue un r\u00f4le essentiel dans la performance des applications, la continuit\u00e9 des activit\u00e9s et la reprise apr\u00e8s sinistre. Une technologie de stockage largement utilis\u00e9e est l’iSCSI (Internet Small Computer Systems Interface), qui permet un acc\u00e8s au stockage au niveau des blocs sur les r\u00e9seaux IP. Pour g\u00e9rer, auditer et d\u00e9panner efficacement les connexions iSCSI, les administrateurs syst\u00e8me ont besoin d’outils pr\u00e9cis.<\/p>\n

C’est l\u00e0 que PowerShell<\/a> devient tr\u00e8s utile. Le script que nous allons explorer fournit une m\u00e9thode optimis\u00e9e et automatis\u00e9e pour obtenir les d\u00e9tails de connexion et de session iSCSI avec PowerShell<\/strong>, en int\u00e9grant ensuiteces informations dans les champs personnalis\u00e9s de NinjaOne pour la documentation et la visibilit\u00e9.<\/p>\n

Contexte<\/h2>\n

iSCSI est fr\u00e9quemment d\u00e9ploy\u00e9 dans les centres de donn\u00e9es pour connecter les serveurs aux syst\u00e8mes de stockage sans avoir recours \u00e0 l’infrastructure Fibre Channel. La surveillance des sessions iSCSI est essentielle pour assurer la connectivit\u00e9, \u00e9valuer les performances et pr\u00e9venir les d\u00e9faillances potentielles. Cependant, l’extraction manuelle de ces informations est non seulement chronophage, mais aussi source d’erreurs.<\/p>\n

Pour les fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a> et les professionnels de l’informatique qui utilisent des plateformes comme NinjaOne, le fait de disposer de ces informations dans une interface centralis\u00e9e (en particulier dans le cadre des champs personnalis\u00e9s d’un appareil) simplifie la documentation et acc\u00e9l\u00e8re l’assistance. Ce script comble cette lacune en automatisant la r\u00e9cup\u00e9ration des d\u00e9tails de la session et de la connexion iSCSI et en les stockant \u00e9ventuellement dans un champ personnalis\u00e9 NinjaOne WYSIWYG.<\/p>\n

Le script<\/h2>\n
<#\r\n\r\n.SYNOPSIS\r\n    Retrieves detailed information about the iSCSI initiator connections and sessions on the local machine.\r\n\r\n.DESCRIPTION\r\n    Gathers details about the iSCSI initiator connections and sessions on the local machine.\r\n    It retrieves information such as connection identifiers, initiator and target addresses, port numbers, session identifiers, and various other session attributes.\r\n    This can also save these details to a specified custom field in a WYSIWYG format if provided.\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.EXAMPLE\r\n    Get-IscsiDetails\r\n\r\n    This command gets the iSCSI initiator details.\r\n\r\nPARAMETER: -WYSIWYGCustomFieldName \"wysiwygCustomFieldName\"\r\n    The name of the custom field to save the iSCSI initiator details.\r\n\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes: Initial release\r\n#>\r\n[CmdletBinding()]\r\nparam(\r\n    [String]\r\n    $WYSIWYGCustomFieldName\r\n)\r\nbegin {\r\n\r\n    if ($env:wysiwygCustomFieldName -notlike \"null\") {\r\n        $WYSIWYGCustomFieldName = $env:wysiwygCustomFieldName\r\n    }\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            [Parameter()]\r\n            [Switch]$Piped\r\n        )\r\n        # Remove the non-breaking space character\r\n        if ($Type -eq \"WYSIWYG\") {\r\n            $Value = $Value -replace '\u00c2\u00a0', '&nbsp;'\r\n        }\r\n        \r\n        # Measure the number of characters in the provided value\r\n        $Characters = $Value | ConvertTo-Json | Measure-Object -Character | Select-Object -ExpandProperty Characters\r\n    \r\n        # Throw an error if the value exceeds the character limit of 200,000 characters\r\n        if ($Piped -and $Characters -ge 200000) {\r\n            throw [System.ArgumentOutOfRangeException]::New(\"Character limit exceeded: the value is greater than or equal to 200,000 characters.\")\r\n        }\r\n    \r\n        if (!$Piped -and $Characters -ge 45000) {\r\n            throw [System.ArgumentOutOfRangeException]::New(\"Character limit exceeded: the value is greater than or equal to 45,000 characters.\")\r\n        }\r\n        \r\n        # Initialize a hashtable for additional documentation parameters\r\n        $DocumentationParams = @{}\r\n    \r\n        # If a document name is provided, add it to the documentation parameters\r\n        if ($DocumentName) { $DocumentationParams[\"DocumentName\"] = $DocumentName }\r\n        \r\n        # Define a list of valid field types\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    \r\n        # Warn the user if the provided type is not valid\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        # Define types that require options to be retrieved\r\n        $NeedsOptions = \"Dropdown\"\r\n    \r\n        # If the property is being set in a document or field and the type needs options, retrieve them\r\n        if ($DocumentName) {\r\n            if ($NeedsOptions -contains $Type) {\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        # Throw an error if there was an issue retrieving the property options\r\n        if ($NinjaPropertyOptions.Exception) { throw $NinjaPropertyOptions }\r\n            \r\n        # Process the property value based on its type\r\n        switch ($Type) {\r\n            \"Checkbox\" {\r\n                # Convert the value to a boolean for Checkbox type\r\n                $NinjaValue = [System.Convert]::ToBoolean($Value)\r\n            }\r\n            \"Date or Date Time\" {\r\n                # Convert the value to a Unix timestamp for Date or Date Time type\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                # Convert the dropdown value to its corresponding 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                # Throw an error if the value is not present in the dropdown options\r\n                if (!($Selection)) {\r\n                    throw [System.ArgumentOutOfRangeException]::New(\"Value is not present in dropdown options.\")\r\n                }\r\n            \r\n                $NinjaValue = $Selection\r\n            }\r\n            default {\r\n                # For other types, use the value as is\r\n                $NinjaValue = $Value\r\n            }\r\n        }\r\n            \r\n        # Set the property value in the document if a document name is provided\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            try {\r\n                # Otherwise, set the standard property value\r\n                if ($Piped) {\r\n                    $CustomField = $NinjaValue | Ninja-Property-Set-Piped -Name $Name 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            catch {\r\n                Write-Host -Object \"[Error] Failed to set custom field.\"\r\n                throw $_.Exception.Message\r\n            }\r\n        }\r\n            \r\n        # Throw an error if setting the property failed\r\n        if ($CustomField.Exception) {\r\n            throw $CustomField\r\n        }\r\n    }\r\n    $ShouldOutputResults = $false\r\n    $HasHadError = $false\r\n}\r\n\r\nprocess {\r\n    try {\r\n        $iscsiConnection = Get-IscsiConnection -ErrorAction Stop\r\n        $iscsiSession = Get-IscsiSession -ErrorAction Stop\r\n    }\r\n    catch [System.Management.Automation.CommandNotFoundException] {\r\n        Write-Host \"[Error] The Get-IscsiConnection or Get-IscsiSession cmdlet is not available on this system.\"\r\n        exit 1\r\n    }\r\n    catch [System.Management.Automation.ActionPreferenceStopException] {\r\n        Write-Host \"[Error] Failed to retrieve iSCSI initiator details.\"\r\n        exit 1\r\n    }\r\n    catch {\r\n        if ($null -eq $iscsiConnection) {\r\n            Write-Host \"[Info] No iSCSI connections found.\"\r\n        }\r\n        if ($null -eq $iscsiSession) {\r\n            Write-Host \"[Info] No iSCSI sessions found.\"\r\n        }\r\n        exit\r\n    }\r\n\r\n    # If a custom field name is provided, save the results to the custom field\r\n    if ($WYSIWYGCustomFieldName) {\r\n        # If there are no iSCSI connections or sessions, output the details to the Activity Feed\r\n        if ($iscsiSession.Count -eq 0) {\r\n            $ShouldOutputResults = $true\r\n            Write-Host \"[Info] No data to save to custom field.\"\r\n        }\r\n        else {\r\n            # Create an HTML string to save to the custom field\r\n\r\n            # iSCSI initiator details\r\n            $wysiwyghtml = \"<h2>iSCSI Connection<\/h2>\"\r\n            $wysiwyghtml += $iscsiConnection | Select-Object -Property @{l = 'Connection Identifier'; e = { $_.ConnectionIdentifier } },\r\n            @{l = 'Initiator Address'; e = { $_.InitiatorAddress } },\r\n            @{l = 'Initiator Port'; e = { $_.InitiatorPortNumber } },\r\n            @{l = 'Target Address'; e = { $_.TargetAddress } },\r\n            @{l = 'Target Port'; e = { $_.TargetPortNumber } } | ConvertTo-Html -Fragment\r\n\r\n            # iSCSI session details\r\n            $wysiwyghtml += \"<h2>iSCSI Session<\/h2>\"\r\n            $wysiwyghtml += $iscsiSession | Select-Object -Property @{l = 'Authentication Type'; e = { $_.AuthenticationType } },\r\n            @{l = 'Initiator Name'; e = { $_.InitiatorInstanceName } },\r\n            @{l = 'Initiator Node Address'; e = { $_.InitiatorNodeAddress } },\r\n            @{l = 'Initiator Portal Address'; e = { $_.InitiatorPortalAddress } },\r\n            @{l = 'Initiator Side Identifier'; e = { $_.InitiatorSideIdentifier } },\r\n            @{l = 'Is Connected'; e = { $_.IsConnected } },\r\n            @{l = 'Is Data Digest'; e = { $_.IsDataDigest } },\r\n            @{l = 'Is Persistent'; e = { $_.IsPersistent } },\r\n            @{l = 'Number of Connections'; e = { $_.NumberOfConnections } },\r\n            @{l = 'Session Identifier'; e = { $_.SessionIdentifier } },\r\n            @{l = 'Target Node Address'; e = { $_.TargetNodeAddress } },\r\n            @{l = 'Target Side Identifier'; e = { $_.TargetSideIdentifier } } | ConvertTo-Html -Fragment\r\n\r\n            # Save the HTML string to the custom field\r\n            try {\r\n                Set-NinjaProperty -Name $WYSIWYGCustomFieldName -Value $wysiwyghtml -Type \"WYSIWYG\" -Piped\r\n                Write-Host \"[Info] Results saved to custom field: $WYSIWYGCustomFieldName\"\r\n                $ShouldOutputResults = $true\r\n            }\r\n            catch {\r\n                Write-Host \"[Error] Failed to save results to custom field: $WYSIWYGCustomFieldName\"\r\n                $ShouldOutputResults = $true\r\n                $HasHadError = $true\r\n            }\r\n        }\r\n    }\r\n    else {\r\n        $ShouldOutputResults = $true\r\n    }\r\n\r\n    # Output the iSCSI initiator details to the Activity Feed\r\n    if ($ShouldOutputResults) {\r\n        # Output the iSCSI initiator details to the Activity Feed\r\n        Write-Host \"---iSCSI Connection---\"\r\n        $iscsiConnection | Select-Object -Property @{l = 'Connection ID'; e = { $_.ConnectionIdentifier } },\r\n        @{l = 'Initiator Address'; e = { $_.InitiatorAddress } },\r\n        @{l = 'Initiator Port'; e = { $_.InitiatorPortNumber } },\r\n        @{l = 'Target Address'; e = { $_.TargetAddress } },\r\n        @{l = 'Target Port'; e = { $_.TargetPortNumber } } | Format-List | Out-String -Width 4000 | Write-Host\r\n\r\n        # Output the iSCSI session details to the Activity Feed\r\n        Write-Host \"---iSCSI Session---\"\r\n        $iscsiSession | Select-Object -Property @{l = 'Auth'; e = { $_.AuthenticationType } },\r\n        @{l = 'Init Name'; e = { $_.InitiatorInstanceName } },\r\n        @{l = 'Init Node Address'; e = { $_.InitiatorNodeAddress } },\r\n        @{l = 'Init Portal Address'; e = { $_.InitiatorPortalAddress } },\r\n        @{l = 'Init Side ID'; e = { $_.InitiatorSideIdentifier } },\r\n        @{l = 'Connected'; e = { $_.IsConnected } },\r\n        @{l = 'Data Digest'; e = { $_.IsDataDigest } },\r\n        @{l = 'Persistent'; e = { $_.IsPersistent } },\r\n        @{l = '# Connections'; e = { $_.NumberOfConnections } },\r\n        @{l = 'SID'; e = { $_.SessionIdentifier } },\r\n        @{l = 'Tgt Node Address'; e = { $_.TargetNodeAddress } },\r\n        @{l = 'Tgt Side ID'; e = { $_.TargetSideIdentifier } } | Format-List | Out-String -Width 4000 | Write-Host\r\n    }\r\n\r\n    if ($HasHadError) {\r\n        exit 1\r\n    }\r\n}\r\n\r\nend {\r\n    \r\n    \r\n    \r\n}<\/pre>\n
 <\/p>\n\n
Description d\u00e9taill\u00e9e<\/h2>\n
Voici une description \u00e9tape par \u00e9tape du d\u00e9roulement du script :<\/p>\n
    \n
  1. Initialisation des param\u00e8tres<\/strong>\n