scrie-gazdă

modul: Microsoft.PowerShell.Utilitate

scrie de ieșire personalizate la o gazdă.

Sintaxa

Descriere

Write-Host cmdlet”e scop principal este de a produce pentru-(host)-display-numai de ieșire, cum ar asprinting text colorat ca atunci când determinat de utilizator pentru intrare în colaborare cu Citit-Gazdă.Write-Host utilizează metoda ToString() pentru a scrieoutput., În schimb, pentru a transmite datele către conductă, utilizați ieșirea de scriere sau implicit.

puteți specifica culoarea textului cu ajutorul ForegroundColor parametru, și puteți specifica thebackground de culoare cu ajutorul BackgroundColor parametru. Parametrul Separator vă permite să specificațiun șir de utilizat pentru a separa obiectele afișate. Rezultatul particular depinde de programul care estehosting PowerShell.

notă

începând cu Windows PowerShell 5.,0, Write-Host este un înveliș pentru Write-Information Acest allowsyou să utilizați Write-Host să emită ieșire la flux de informații. Aceasta permite captarea sau suprimarea datelor scrise folosind Write-Host păstrând compatibilitatea înapoi.

$InformationPreference preferințe variabilă și InformationAction parametru comun face notaffect Write-Host mesaje. Excepție de la această regulă este -InformationAction Ignore, whicheffectively suprimă Write-Host ieșire., (a se vedea „Exemplul 5”)

Exemple

Exemplu 1: Scrie la consola fără a adăuga o nouă linie

Această comandă afișează șirul „nu newline test” cu NoNewline parametru.un al doilea șir este scris, dar se termină pe aceeași linie ca prima din cauza absenței unei linii care separă șirurile.,

Exemplul 2: Scrie la consola și include un separator

Exemplul 3: Scrie cu alt text și culorile de fundal

Această comandă afișează numerele de la doi la doisprezece. Se folosește ForegroundColorparametru de ieșire de culoare verde închis text și BackgroundColor parametru pentru a afișa o whitebackground.

Exemplul 4: Scrieți cu diferite culori de text și fundal

această comandă afișează șirul „roșu pe text alb.,”Textul este roșu, așa cum este definit de parametrulForegroundColor. Fundalul este alb, așa cum este definit de parametrul BackgroundColor.

Exemplul 5: Suprima producția de Write-Host

Aceste comenzi suprima în mod eficient producția de Write-Host cmdlet. Primul utilizează parametrulInformationActioncu valoarea Ignore pentru a suprima ieșirea în fluxul de informații.,Al doilea exemplu redirecționează fluxul de informații al comenzii către variabila $null șiprin urmare, o suprimă.

parametrii

– BackgroundColor

specifică culoarea de fundal. Nu există nici o implicit.,ellow

  • White
  • Type: ConsoleColor
    Accepted values: Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
    Position: Named
    Default value: None
    Accept pipeline input: False
    Accept wildcard characters: False
    -ForegroundColor

    Specifies the text color., Nu există nici o implicit.,

    Type: ConsoleColor Accepted values: Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False
    -NoNewline

    The string representations of the input objects are concatenated to form the output., Nu există spații saunewlines sunt introduse între șirurile de ieșire. Nu se adaugă nicio linie nouă după ultimul șir de ieșire.

    Tip: SwitchParameter
    Poziție: Nume
    valoare Implicită: Nimic
    Accepta conducta de intrare: False
    Acceptă metacaractere: False
    -Obiect

    Obiecte pentru a afișa în gazdă.,

    Type: Object
    Aliases: Msg, Message
    Position: 0
    Default value: None
    Accept pipeline input: True
    Accept wildcard characters: False
    -Separator

    Specifies a separator string to insert between objects displayed by the host.,

    Type: Object
    Position: Named
    Default value: None
    Accept pipeline input: False
    Accept wildcard characters: False

    Inputs

    Object

    You can pipe objects to be written to the host.

    Outputs

    None

    Write-Host sends the objects to the host. It does not return any objects., Cu toate acestea, gazda afișează obiectele pe care Write-Host le trimite.

    Note

    • când scrieți o colecție gazdei, elementele colecției sunt tipărite pe aceeași linieseparate de un singur spațiu. Acest lucru poate fi anulat cu parametrul Separator.tipurile de date non-primitive, cum ar fi obiectele cu proprietăți, pot provoca rezultate neașteptate și nu oferă rezultate semnificative. De exemplu, Write-Host @{a = 1; b = 2} va imprimaSystem.Collections.DictionaryEntry System.Collections.DictionaryEntry la gazdă.,

  • Clear-Host
  • Out-Host
  • Write-Debug
  • Write-Error
  • Write-Output
  • Write-Progress
  • Write-Verbose
  • Write-Warning
  • Lasă un răspuns

    Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *