New-DSAccountLifecyclePolicyInfo

Sinopsis

Crear una nueva política de ciclo de vida de cuenta.

Sintaxis

Type (predeterminado)

New-DSAccountLifecyclePolicyInfo [-Source <AccountLifecyclePolicyProviderMode>]
 [-PolicyType <AccountLifecyclePolicyType>] [<CommonParameters>]

GetByID

New-DSAccountLifecyclePolicyInfo -PolicyID <guid> [<CommonParameters>]

Descripción

Cree una nueva política de ciclo de vida de cuenta en un formato compatible con PowerShell que se pueda utilizar al inicializar o actualizar proveedores PAM. Para modificar configuraciones específicas de la política, es necesario modificar las propiedades del objeto devuelto.

Plantilla de contraseña: establezca primero $policy.Policy.PasswordTemplate.Mode = 'Custom'. Asigne un ID de plantilla de contraseña a $policy.Policy.PasswordTemplate.TemplateID (obtenido de Get-DSPasswordPolicy).

Restablecimiento de contraseña: configure la rotación automática de contraseñas estableciendo $policy.Policy.PasswordReset.ScheduleMode = 'Custom'. Especifique la frecuencia con $policy.Policy.PasswordReset.ScheduleFrequency. Establezca la unidad con $policy.Policy.PasswordReset.ScheduleFrequencyUnit (Day, Hour, etc.). Opcionalmente, establezca la hora con $policy.Policy.PasswordReset.ScheduleAtDateTime.

Scripts de propagación de contraseñas: configure la propagación de contraseñas estableciendo $policy.Policy.Propagation.Mode = 'Custom'. Asigne los ID de los scripts a $policy.Policy.Propagation.ScriptConfigurationIds (obtenidos de Get-DSScriptConfigurationSummary).

Ejemplos

Ejemplo 1

PS C:\> $template = Get-DSPasswordPolicy -Name "Strong password"
PS C:\> $script = Get-DSScriptConfigurationSummary -Name "My password propagation script"
PS C:\> $policy = New-DSAccountLifecyclePolicyInfo -Source Custom -PolicyType Custom
PS C:\> $gateway = Get-DSGateway -Name 'MyGateway'
PS C:\> $policy.Policy.PasswordTemplate.Mode = 'Custom'
PS C:\> $policy.Policy.PasswordTemplate.TemplateID = $template.ID
PS C:\> $policy.Policy.CheckInAction.Mode = 'Custom'
PS C:\> $policy.Policy.CheckInAction.Actions = @('ResetPassword')
PS C:\> $policy.Policy.PasswordReset.ScheduleMode = 'Custom'
PS C:\> $policy.Policy.PasswordReset.ScheduleFrequency = 30
PS C:\> $policy.Policy.PasswordReset.ScheduleFrequencyUnit = 'Day'
PS C:\> $policy.Policy.PasswordReset.ScheduleAtDateTime = Get-Date -Hour 14 -Minute 0 -Second 0
PS C:\> $policy.Policy.Propagation.Mode = 'Custom'
PS C:\> $policy.Policy.Propagation.ScriptConfigurationIds = @($script.ID)
PS C:\> New-DSPamProvider -Name "MyProvider" -CredentialType DomainUser -DomainName "mydomain.loc" -Username "admin" -Password "P@ssw0rd" -AccountLifecyclePolicy $policy -Gateway $gateway

Cree un proveedor PAM con una política de ciclo de vida de cuenta personalizada e inicialice varias propiedades con valores personalizados. Nota: 'ResetPassword' en CheckInAction.Actions corresponde a la opción 'Rotación de contraseñas' en la interfaz de usuario.

Ejemplo 2

PS C:\> $customPolicy = Get-DSAccountLifecyclePolicy -Name "My Custom Policy"
PS C:\> $policy = New-DSAccountLifecyclePolicyInfo -PolicyID $customPolicy.ID
PS C:\> New-DSPamProvider -Name "MyProvider" -CredentialType DomainUser -DomainName "mydomain.loc" -Username "admin" -Password "P@ssw0rd" -AccountLifecyclePolicy $policy

Cree un proveedor PAM utilizando una política de ciclo de vida de cuenta existente. Source se establece automáticamente en Custom.

Parámetros

-PolicyID

El ID de una política de ciclo de vida de cuenta existente. La nueva política utilizará la configuración de esta política. El Source de la política devuelta se establece automáticamente en Custom.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetByID
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PolicyType

El tipo de política (Default o Custom). Esto establecerá el campo PolicyID del objeto devuelto en un valor equivalente.

Type: RemoteDesktopManager.PowerShellModule.Private.enums.AccountLifecyclePolicyType
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Type
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Source

El origen de la política (Default, Custom o None)

Type: RemoteDesktopManager.PowerShellModule.Private.enums.AccountLifecyclePolicyProviderMode
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Type
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

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

Salidas

RemoteDesktopManager.PowerShellModule.Private.models.PSAccountLifecyclePolicyInfo

Notas

Para más información, escriba "Get-Help New-DSAccountLifecyclePolicyInfo -detailed". Para información técnica, escriba "Get-Help New-DSAccountLifecyclePolicyInfo -full".