Partager via

Out-Default

Module:
Microsoft.PowerShell.Core Module

Envoie la sortie au formateur par défaut et à l’applet de commande de sortie par défaut.

Syntaxe

Default (Par défaut) 

Out-Default
    [-Transcript]
    [-InputObject <PSObject>]
    [<CommonParameters>]

Description

PowerShell ajoute automatiquement Out-Default à la fin de chaque pipeline. Out-Default décide comment mettre en forme et générer le flux d’objets. Si le flux d’objets est un flux de chaînes, Out-Default les canalise directement vers Out-Host qui appelle les API appropriées fournies par l’hôte. Si le flux d’objets ne contient pas de chaînes, Out-Default inspecte l’objet pour déterminer ce qu’il faut faire. Tout d’abord, il examine le type d’objet et détermine s’il existe une vue enregistrée pour ce type d’objet.

PowerShell définit un schéma XML et un mécanisme (l’applet de commande Update-FormatData) où tout le monde peut inscrire des vues pour un type d’objet. Vous pouvez spécifier ensemble, liste, tableau ou vues personnalisées pour n’importe quel type d’objet. Les vues spécifient les propriétés à afficher et la façon dont elles doivent être affichées. Si une vue est inscrite, elle définit le formatteur approprié à utiliser. Par conséquent, si la vue enregistrée est une vue de table , Out-Default diffuse les objets vers Format-Table | Out-Host. Format-Table transforme les objets en flux d’enregistrements de mise en forme (pilotés par les données de la définition de vue) et Out-Host transforme les enregistrements de mise en forme en appels sur l’interface hôte.

Cette applet de commande n’est pas destinée à être utilisée par l’utilisateur final. D’autres applets de commande sont recommandées pour contrôler la sortie, comme Out-Host, ou l’utilisation d’Format-*applets de commande et du fichier Format.ps1xml pour contrôler la mise en forme.

Exemples

Exemple 1

Bien que cette applet de commande ne soit pas destinée à être exécutée directement par l’utilisateur final, elle peut être.

Get-Process | Select-Object -First 5 | Out-Default

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     12     2.56       5.20       0.00    7376   0 aesm_service
     48    34.32      18.10      26.64    9320  13 AlertusDesktopAlert
     24    13.97      12.74       0.77   12656  13 ApplicationFrameHost
      8     1.79       4.41       0.00    8180   0 AppVShNotify
      9     1.99       5.07       0.19   19320  13 AppVShNotify

Aucune erreur n’est levée lors de l’utilisation de Out-Default, mais la sortie n’est pas modifiée si elle n’est pas explicitement appelée.

Paramètres

-InputObject

Accepte une entrée pour l'applet de commande.

Propriétés du paramètre

Type:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Transcript

Détermine si la sortie doit être envoyée aux services de transcription de PowerShell.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.