> 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-udradiogroup.md).

# New-UDRadioGroup

New-UDRadioGroup envuelve un conjunto de botones New-UDRadio en PowerShell Universal para que solo se pueda seleccionar una opción del grupo a la vez.

### Sinopsis

Crea un grupo de botones de opción.

### Sintaxis

```powershell
New-UDRadioGroup [[-Id] <String>] [[-Label] <String>] [[-Children] <ScriptBlock>] [[-OnChange] <Endpoint>] [[-Value] <String>] [[-ClassName] <String>] [[-DefaultValue] <String>] [-Disabled] [[-Sx] <Hashtable>] [[-Style] <Hashtable>] [[-Aria] <ScriptBlock>] [<CommonParameters>]
```

### Descripción

Crea un grupo de botones de opción. Dentro de un grupo, solo se podrá seleccionar un botón de opción.

### Parámetros

#### -Id

El ID del componente. De forma predeterminada es un GUID aleatorio.

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

#### -Label

La etiqueta que se muestra para este grupo de botones de opción.

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

#### -Children

Los botones de opción que se incluirán dentro de este grupo.

```
Required?                    false
Position?                    3
Default value                {
                    New-UDRadio -Label "Option 1" -Value 1
                    New-UDRadio -Label "Option 2" -Value 2
                }
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -OnChange

Un bloque de script que se llama cuando cambia la selección del grupo de botones de opción. La variable $EventData incluirá el valor del botón de opción seleccionado.

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

#### -Value

El valor seleccionado para este grupo de botones de opción.

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

#### -ClassName

Una clase CSS que se aplicará al grupo de botones de opción.

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

#### -DefaultValue

El valor predeterminado para este grupo de botones de opción.

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

#### -Disabled

Si el grupo de botones de opción está deshabilitado.

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

#### -Sx

La prop sx le permite añadir estilos personalizados a su componente.

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

#### -Style

La prop style le permite añadir estilos personalizados a su componente.

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

#### -Aria

Un bloque de script de llamadas a `New-UDAriaAttribute` que suministra atributos ARIA o de rol para el grupo de botones de opción.

```
Required?                    false
Position?                    named
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 obtener más información, consulte [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Salidas

### Ejemplos

#### Ejemplo 1: grupo de botones de opción básico

```powershell
New-UDRadioGroup -Label 'group' -Id 'radio1' -Children {
   New-UDRadio -Value 'Adam' -Label 'Adam'  -Id 'adam'
   New-UDRadio -Value 'Sarah' -Label 'Sarah' -Id 'sarah'
   New-UDRadio -Value 'Austin' -Label 'Austin' -Id 'austin'
}
```

Crea un grupo de botones de opción básico con tres botones de opción.

#### Ejemplo 2: OnChange

```powershell
New-UDRadioGroup -Label 'group' -Id 'radio2' -Children {
   New-UDRadio -Value 'Adam' -Label 'Adam'  -Id 'adam'
   New-UDRadio -Value 'Sarah' -Label 'Sarah' -Id 'sarah'
   New-UDRadio -Value 'Austin' -Label 'Austin' -Id 'austin'
} -OnChange {
   Show-UDToast -Message "Radio selected: $EventData"
}
```

Crea un grupo de botones de opción básico con tres botones de opción y un bloque de script OnChange.

#### Ejemplo 3: deshabilitado

```powershell
New-UDRadioGroup -Label 'group' -Id 'radio3' -Children {
   New-UDRadio -Value 'Adam' -Label 'Adam'  -Id 'adam'
   New-UDRadio -Value 'Sarah' -Label 'Sarah' -Id 'sarah'
   New-UDRadio -Value 'Austin' -Label 'Austin' -Id 'austin'
} -Disabled
```

Crea un grupo de botones de opción básico con tres botones de opción y deshabilita el grupo.

#### Ejemplo 4: valor predeterminado

```powershell
New-UDRadioGroup -Label 'group' -Id 'radio4' -Children {
   New-UDRadio -Value 'Adam' -Label 'Adam'  -Id 'adam'
   New-UDRadio -Value 'Sarah' -Label 'Sarah' -Id 'sarah'
   New-UDRadio -Value 'Austin' -Label 'Austin' -Id 'austin'
} -DefaultValue 'Sarah'
```

Crea un grupo de botones de opción básico con tres botones de opción y establece el valor predeterminado en 'Sarah'.

#### Ejemplo 5: colocación de la etiqueta

```powershell
New-UDRadioGroup -Label 'group' -Id 'radio4' -Children {
   New-UDRadio -Value 'Adam' -Label 'Adam'  -Id 'adam' -LabelPlacement 'start'
   New-UDRadio -Value 'Sarah' -Label 'Sarah' -Id 'sarah' -LabelPlacement 'start'
   New-UDRadio -Value 'Austin' -Label 'Austin' -Id 'austin' -LabelPlacement 'start'
} -DefaultValue 'Sarah'
```

Crea un grupo de botones de opción básico con tres botones de opción y establece la colocación de la etiqueta en 'start'.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/es/comandos-de-powershell/new-udradiogroup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.