> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/es/comandos-de-powershell/new-udbadge.md). # New-UDBadge New-UDBadge crea un pequeño componente de insignia en PowerShell Universal que muestra un contador o un indicador de estado en la esquina de su elemento secundario. ### Sinopsis Badge genera una pequeña insignia en la parte superior derecha de su elemento o elementos secundarios. ### Sintaxis ```powershell New-UDBadge [[-Id] ] [[-Color] ] [[-Children] ] [[-BadgeContent] ] [-Invisible] [[-Max] ] [[-Overlap] ] [-ShowZero] [[-Variant] ] [[-Location] ] [[-Sx] ] [] ``` ### Descripción Badge genera una pequeña insignia en la parte superior derecha de su elemento o elementos secundarios. ### Parámetros #### -Id El ID del componente. Por defecto es un GUID aleatorio. ``` Required? false Position? 1 Default value ([Guid]::NewGuid()).ToString() Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Color El color de la insignia. Los valores válidos son: "default", "primary", "secondary", "error", "info", "success", "warning" ``` Required? false Position? 2 Default value primary Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Children El contenido al que se adjunta la insignia. ``` Required? false Position? 3 Default value {} Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -BadgeContent El contenido que se muestra dentro de la insignia. ``` Required? false Position? 4 Default value {} Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Invisible Si la insignia es invisible. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Max El número máximo que se muestra. Si el número es mayor que este, se mostrará como "99+". El valor predeterminado es 99. ``` Required? false Position? 5 Default value 99 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Overlap El solapamiento de la insignia. Los valores válidos son: "circular", "rectangular" ``` Required? false Position? 6 Default value rectangular Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ShowZero Si se muestra la insignia cuando badgeContent es 0. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Variant La variante de la insignia. Los valores válidos son: "standard", "dot" ``` Required? false Position? 7 Default value standard Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Location La ubicación de la insignia. Los valores válidos son: "topright", "topleft", "bottomright", "bottomleft" ``` Required? false Position? 8 Default value topright Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Sx ``` Required? false Position? 9 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### Parámetros comunes Este cmdlet admite los parámetros comunes: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable y OutVariable. Para más información, consulte [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Notas Notas generales \[Component("Badge", "Badge", "Creates a new badge.")] ### Ejemplos #### Ejemplo 1: insignia primary ```powershell New-UDBadge -Color primary -BadgeContent { 4 } -Children { New-UDButton -Text "Primary" } -Id 'badge1' ``` Muestra una insignia con el texto "4" en un botón primary. #### Ejemplo 2: color ```powershell New-UDBadge -Color secondary -BadgeContent { 4 } -Children { New-UDIcon -Icon Envelope -Size 2x } -Id 'badge2' New-UDBadge -Color error -BadgeContent { 4 } -Children { New-UDIcon -Icon Envelope -Size 2x } -Id 'badge3' ``` Cambia el color de la insignia. #### Ejemplo 3: ShowZero ```powershell New-UDBadge -ShowZero -BadgeContent { 0 } -Children { New-UDIcon -Icon Envelope -Size 2x } -Id 'badge4' ``` Muestra la insignia cuando badgeContent es 0. #### Ejemplo 4: Max ```powershell New-UDBadge -Max 10 -BadgeContent { 11 } -Children { New-UDIcon -Icon Envelope -Size 2x } -Id 'badge5' ``` El número máximo que se muestra. Si el número es mayor que este, se mostrará como "99+". El valor predeterminado es 99. #### Ejemplo 5: Overlap ```powershell New-UDBadge -Overlap circular -BadgeContent { 4 } -Children { New-UDIcon -Icon Envelope -Size 2x } -Id 'badge6' ``` El solapamiento de la insignia. #### Ejemplo 6: punto ```powershell New-UDBadge -Variant dot -BadgeContent { 4 } -Children { New-UDIcon -Icon Envelope -Size 2x } -Id 'badge7' ``` Muestra una insignia de punto. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/es/comandos-de-powershell/new-udbadge.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.