Set-PSBreakpoint

Set-PSBreakpoint -Command <string[]> [[-Script] <string[]>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint [-Script] <string[]> [-Line] <Int32[]> [[-Column] <int>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint -Variable <string[]> [[-Script] <string[]>] [-Mode {<Read> | <Write> | <ReadWrite>}] [-Action <scriptblock>] [<CommonParameters>]

C:\PS>set-psbreakpoint -script sample.ps1 -line 5

Column     : 0
Line       : 5
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Description
-----------
Cette commande définit un point d'arrêt à la ligne 5 du script Sample.ps1. Par conséquent, lorsque le script s'exécute, il s'arrête immédiatement avant la ligne 5.

Lorsque vous définissez un nouveau point d'arrêt par numéro de ligne, l'applet de commande Set-PSBreakpoint génère un objet point d'arrêt de ligne (System.Management.Automation.LineBreakpoint) qui inclut l'ID de point d'arrêt et le nombre d'accès, comme indiqué dans l'exemple de sortie suivant.

C:\PS>set-psbreakpoint -command Increment -script sample.ps1

Command    : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 1
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Description
-----------
Cette commande crée un point d'arrêt de commande sur la fonction Increment de l'applet de commande Sample.ps1. Le script cesse de s'exécuter immédiatement avant chaque appel à la fonction spécifiée.

Le résultat est un objet point d'arrêt de commande. Avant l'exécution du script, la valeur de la propriété HitCount est 0.

C:\PS>set-psbreakpoint -script sample.ps1 -variable Server -Mode ReadWrite

Description
-----------
Cette commande définit un point d'arrêt sur la variable Server du script Sample.ps1. Elle utilise le paramètre Mode avec la valeur ReadWrite pour arrêter l'exécution lorsque la valeur de la variable est lue et juste avant que la valeur change.

C:\PS>set-psbreakpoint -script Sample.ps1 -command "write*"

Description
-----------
Cette commande définit un point d'arrêt sur chaque commande du script Sample.ps1 commençant par « write », telle que « write-host ».

C:\PS>set-psbreakpoint -script test.ps1 -command DiskTest `
  -action { (if $disk -gt 2) { break } }

Description
-----------
Cette commande interrompt l'exécution à la fonction DiskTest du script Test.ps1 uniquement lorsque la valeur de la variable $disk est supérieure à 2.

Elle utilise l'applet de commande Set-PSBreakpoint pour définir un point d'arrêt de commande sur la fonction DiskTest. La valeur de l'action est un bloc de script qui teste la valeur de la variable $disk dans la fonction.

L'action utilise le mot clé BREAK pour arrêter l'exécution si la condition est rencontrée. La valeur alternative (et par défaut) est CONTINUE.

C:\PS>set-psbreakpoint -command checkpoint-computer

Id       : 0
Command  : checkpoint-computer
Enabled  : True
HitCount : 0
Action   :

C:\PS> function CheckLog {
>> get-eventlog -log Application | 
>> where {($_.source -like "TestApp") -and ($_.Message -like "*failed*")}
>>}
>>
C:\PS> Checklog
DEBUG: Hit breakpoint(s)
DEBUG:  Function breakpoint on 'prompt:Checklog'
C:\PS>>>

Description
-----------
Cette commande définit un point d'arrêt sur la fonction CheckLog. Étant donné que la commande ne spécifie pas de script, le point d'arrêt est défini sur tout élément qui s'exécute dans la session active. Le débogueur arrête l'exécution lorsque la fonction est appelée, pas lorsqu'elle est déclarée.

C:\PS>set-psbreakpoint -script sample.ps1 -line 1, 14, 19 -column 2 -action {&(log.ps1)}

Column     : 2
Line       : 1
Action     :
Enabled    : True
HitCount   : 0
Id         : 6
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 14
Action     :
Enabled    : True
HitCount   : 0
Id         : 7
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 19
Action     :
Enabled    : True
HitCount   : 0
Id         : 8
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Description
-----------
Cette commande définit trois points d'arrêt de ligne dans le script Sample.ps1. Elle définit un point d'arrêt au niveau de la colonne 2 sur chaque ligne spécifiée dans le script. L'action spécifiée dans le paramètre Action s'applique à tous les points d'arrêt.