New-UDSwitch

Synopsis

Crée un nouveau commutateur.

Syntaxe

New-UDSwitch [[-Id] <String>] [-Disabled] [[-OnChange] <Endpoint>] [[-Checked] <Boolean>] [[-ClassName] <String>] [[-Color] <String>] [[-Label] <String>] [[-LabelComponent] <Hashtable>] [[-CheckedLabel] <String>] [[-CheckedLabelComponent] <Hashtable>] [[-UncheckedLabel] <String>] [[-UncheckedLabelComponent] <Hashtable>] [[-Size] <String>] [[-LabelPlacement] <String>] [-CheckStyle] [[-Sx] <Hashtable>] [[-Style] <Hashtable>] [<CommonParameters>]

Description

Crée un nouveau commutateur. Un commutateur se comporte comme une case à cocher, mais son apparence est un peu différente.

Paramètres

-Id

L'ID du composant. Sa valeur par défaut est un GUID aléatoire.

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

-Disabled

Indique si ce commutateur est désactivé.

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

-OnChange

Un bloc de script qui est appelé lorsque ce commutateur change. La variable $EventData contiendra la valeur cochée ($true$false).

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

-Checked

Indique si ce commutateur est coché.

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

-ClassName

Une classe CSS à appliquer au commutateur.

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

-Color

La couleur du thème à appliquer à ce commutateur.

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

-Label

L'étiquette à afficher à côté du commutateur

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

-LabelComponent

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

-CheckedLabel

L'étiquette à afficher lorsque le commutateur est coché

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

-CheckedLabelComponent

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

-UncheckedLabel

L'étiquette à afficher lorsque le commutateur n'est pas coché

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

-UncheckedLabelComponent

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

-Size

La taille du commutateur. Les valeurs valides sont : « small », « medium »

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

-LabelPlacement

Le placement de l'étiquette. Les valeurs valides sont : « top », « start », « right », « bottom »

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

-CheckStyle

Style de commutateur avec des icônes cochée et non cochée pour les daltoniens.

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

-Sx

Une table de hachage de styles basés sur le thème à appliquer au commutateur.

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

-Style

Une table de hachage de styles à appliquer au commutateur.

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

Paramètres communs

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'informations, consultez about_CommonParameters.

Sorties

Exemples

Exemple 1 : Commutateur de base

New-UDSwitch -Id 'switch1' -Checked $true

Crée un commutateur de base.

Exemple 2 : OnChange

New-UDSwitch -Id 'switch2' -Checked $true -OnChange {
    Show-UDToast -Message "Switch changed to $($EventData)"
}

Crée un commutateur avec un bloc de script OnChange.

Exemple 3 : Désactivé

New-UDSwitch -Id 'switch3' -Disabled

Crée un commutateur désactivé.

Exemple 4 : Étiquette

New-UDSwitch -Id 'switch4' -Checked $true -Label 'On' -UncheckedLabel 'Off'

Crée un commutateur avec une étiquette.

Exemple 5 : Placement de l'étiquette

New-UDSwitch -Id 'switch5' -Checked $true -Label 'On' -UncheckedLabel 'Off' -LabelPlacement 'bottom'

Crée un commutateur avec une étiquette et un placement d'étiquette.

Exemple 6 : Style de coche

New-UDSwitch -Id 'switch6' -Checked $true -Label 'On' -UncheckedLabel 'Off' -LabelPlacement 'bottom' -CheckStyle

Crée un commutateur avec une étiquette, un placement d'étiquette et un style de coche.