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.
-
-Idespecifica el identificador de la directiva para la que desea establecer valores. -
DisplayNameespecifica 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.
-
-Idespecifica el identificador de la directiva para la que desea establecer valores. -
Definitionespecifica 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.
-
-Idespecifica el identificador de la directiva para la que desea establecer valores. -
-IsOrganizationDefaultSi 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.
-
-Idespecifica el identificador de la directiva para la que desea establecer valores. -
-Typeespecifica el tipo de directiva. En este ejemplo,ActivityBasedTimeoutPolicyrepresenta 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.