New-UDAlert

Übersicht

Ein Alert zeigt eine kurze, wichtige Nachricht so an, dass sie die Aufmerksamkeit des Benutzers erregt, ohne ihn bei seiner Aufgabe zu unterbrechen.

Syntax

New-UDAlert [-Id <String>] [-Severity <String>] [-Text <String>] [-Title <String>] [-ClassName <String>] [-Style <Hashtable>] [-Dense] [<CommonParameters>]

New-UDAlert [-Id <String>] [-Severity <String>] [-Children <ScriptBlock>] [-Title <String>] [-ClassName <String>] [-Style <Hashtable>] [-Dense] [<CommonParameters>]

Beschreibung

Ein Alert zeigt eine kurze, wichtige Nachricht so an, dass sie die Aufmerksamkeit des Benutzers erregt, ohne ihn bei seiner Aufgabe zu unterbrechen.

Parameter

-Id

Die ID dieser Komponente.

Required?                    false
Position?                    named
Default value                [Guid]::NewGuid()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Severity

Der Schweregrad dieses Alerts. Gültige Werte sind: "success", "error", "warning", "info"

Required?                    false
Position?                    named
Default value                success
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Children

Inhalt des Alerts.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Text

Text für den Hauptteil des Alerts.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Title

Ein Titel für diesen Alert.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ClassName

Eine CSS-Klasse, die auf den Alert angewendet wird.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Style

Eine Hashtabelle mit Stilen, die auf diese Komponente angewendet werden.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Dense

Reduziert den vertikalen Innenabstand des Alerts.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

Beispiele

Beispiel 1: Einfacher Alert

New-UDStack -Content {
   New-UDAlert -Severity 'error'  -Title "Error" -Id 'alert1'
   New-UDAlert -Severity 'warning' -Title "Warning" -Id 'alert2'
   New-UDAlert -Severity 'info'  -Title "Info" -Id 'alert3'
   New-UDAlert -Severity 'success' -Title "Success" -Id 'alert4'
} -Direction 'column'

Der Alert bietet vier Schweregrade, die ein charakteristisches Symbol und eine charakteristische Farbe festlegen.

Beispiel 2: Text und Titel

New-UDStack -Content {
   New-UDAlert -Severity 'error' -Title 'Error' -Text 'This is an error alert' -Id 'alert5'
   New-UDAlert -Severity 'warning'  -Title 'Warning' -Text 'This is an warning alert' -Id 'alert6'
   New-UDAlert -Severity 'info' -Title 'Info' -Text 'This is an error info' -Id 'alert7'
   New-UDAlert -Severity 'success' -Title 'Success' -Text 'This is an success alert' -Id 'alert8'
} -Direction 'column'

Sie können den Parameter -Title verwenden, um einen formatierten Titel über dem Inhalt anzuzeigen.

Beispiel 3: Dense

New-UDStack -Content {
   New-UDAlert -Severity 'error'  -Title "Error" -Id 'alert9' -Dense
   New-UDAlert -Severity 'warning' -Title "Warning" -Id 'alert10' -Dense
   New-UDAlert -Severity 'info'  -Title "Info" -Id 'alert11' -Dense
   New-UDAlert -Severity 'success' -Title "Success" -Id 'alert12' -Dense
} -Direction 'column'

Sie können den Parameter -Dense verwenden, um den vertikalen Innenabstand des Alerts zu reduzieren.