Set-EntraBetaPolicy

Actualiza una directiva.

Sintaxis

Default (valor predeterminado)

Set-EntraBetaPolicy

    -Id <String>
    [-Definition <System.Collections.Generic.List`1[System.String]>]
    [-DisplayName <String>]
    [-Type <String>]
    [-IsOrganizationDefault <Boolean>]
    [<CommonParameters>]

Description

El Set-EntraBetaPolicy cmdlet establece una directiva en Microsoft Entra ID. Especifique Id el parámetro para actualizar una directiva específica.

Ejemplos

Ejemplo 1: Actualización de un nombre para mostrar de directiva

Connect-Entra -Scopes 'Policy.ReadWrite.ApplicationConfiguration'
$policy = Get-EntraBetaPolicy | Where-Object { $_.DisplayName -eq 'Microsoft User Default Recommended Policy' }
Set-EntraBetaPolicy -Id $policy.Id -DisplayName 'NewUpdated'

Este comando actualiza el nombre para mostrar de la directiva especificada en Microsoft Entra ID.

  • -Id especifica el identificador de la directiva para la que desea establecer valores.
  • DisplayName especifica el nombre para mostrar.

Ejemplo 2: Actualización de una definición de directiva

Connect-Entra -Scopes 'Policy.ReadWrite.ApplicationConfiguration'
$policy = Get-EntraBetaPolicy | Where-Object { $_.DisplayName -eq 'Microsoft User Default Recommended Policy' }
$definition = @('{"activityBasedTimeoutPolicies":{"AlternateLoginIDLookup":true, "IncludedUserIds":["UserID"]}}')
Set-EntraBetaPolicy -Id $policy.Id -Definition $definition

Este comando actualiza la definición de la directiva especificada en Microsoft Entra ID.

  • -Id especifica el identificador de la directiva para la que desea establecer valores.
  • Definition especifica la matriz de JSON con cadena que contiene todas las reglas de la directiva. En este ejemplo, @('{"activityBasedTimeoutPolicies":{"AlternateLoginIDLookup":true, "IncludedUserIds":["UserID"]}}') representa la definición de activityBasedTimeoutPolicy.

Ejemplo 3: Actualización predeterminada de una organización de directivas

Connect-Entra -Scopes 'Policy.ReadWrite.ApplicationConfiguration'
$policy = Get-EntraBetaPolicy | Where-Object { $_.DisplayName -eq 'Microsoft User Default Recommended Policy' }
Set-EntraBetaPolicy -Id $policy.Id -IsOrganizationDefault $false

Este comando actualiza el valor predeterminado de la organización de la directiva especificada en Microsoft Entra ID.

  • -Id especifica el identificador de la directiva para la que desea establecer valores.
  • -IsOrganizationDefault Si es true, activa esta directiva. Solo una directiva del mismo tipo puede ser el valor predeterminado de la organización. Opcional, el valor predeterminado es false.

Ejemplo 4: Tipo de directiva de actualización

Connect-Entra -Scopes 'Policy.ReadWrite.ApplicationConfiguration'
$policy = Get-EntraBetaPolicy | Where-Object { $_.DisplayName -eq 'Microsoft User Default Recommended Policy' }
Set-EntraBetaPolicy -Id $policy.Id -Type 'ActivityBasedTimeoutPolicy'

En este ejemplo se muestra cómo actualizar la type propiedad de una directiva especificada en Microsoft Entra ID.

  • -Id especifica el identificador de la directiva para la que desea establecer valores.
  • -Type especifica el tipo de directiva. En este ejemplo, ActivityBasedTimeoutPolicy representa el tipo de directiva.

Parámetros

-Definition

Especifica la matriz de JSON con cadena que contiene todas las reglas de la directiva. Por ejemplo, -Definition @('{"TokenLifetimePolicy":{"Version":1,"MaxInactiveTime":"20:00:00"}}').

Propiedades de parámetro

Tipo:

System.Collections.Generic.List`1[System.String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

Especifica el nombre para mostrar.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

Identificador de la directiva para la que desea establecer valores.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsOrganizationDefault

True si esta directiva es el valor predeterminado de la organización.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Type

Especifica el tipo de directiva. Para las duraciones de tokens, use "TokenLifetimePolicy".

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.