New-DSAccountLifecyclePolicyInfo

Übersicht

Erstellen Sie eine neue Kontolebenszyklus-Richtlinie.

Syntax

Typ (Standard)

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

GetByID

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

Beschreibung

Erstellen Sie eine neue Kontolebenszyklus-Richtlinie in einem PowerShell-freundlichen Format, das beim Initialisieren oder Aktualisieren von PAM-Anbietern verwendet werden kann. Um bestimmte Einstellungen der Richtlinie zu ändern, müssen die Eigenschaften des zurückgegebenen Objekts geändert werden.

Passwortvorlage: Setzen Sie zuerst $policy.Policy.PasswordTemplate.Mode = 'Custom'. Weisen Sie $policy.Policy.PasswordTemplate.TemplateID eine Passwortvorlagen-ID zu (erhalten über Get-DSPasswordPolicy).

Passwortzurücksetzung: Konfigurieren Sie die automatische Passwortrotation, indem Sie $policy.Policy.PasswordReset.ScheduleMode = 'Custom' setzen. Geben Sie die Häufigkeit mit $policy.Policy.PasswordReset.ScheduleFrequency an. Legen Sie die Einheit mit $policy.Policy.PasswordReset.ScheduleFrequencyUnit fest (Day, Hour usw.). Legen Sie optional die Uhrzeit mit $policy.Policy.PasswordReset.ScheduleAtDateTime fest.

Passwortweitergabe-Skripte: Konfigurieren Sie die Passwortweitergabe, indem Sie $policy.Policy.Propagation.Mode = 'Custom' setzen. Weisen Sie $policy.Policy.Propagation.ScriptConfigurationIds Skript-IDs zu (erhalten über Get-DSScriptConfigurationSummary).

Beispiele

Beispiel 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

Erstellen Sie einen PAM-Anbieter mit einer benutzerdefinierten Kontolebenszyklus-Richtlinie und initialisieren Sie mehrere Eigenschaften mit benutzerdefinierten Werten. Hinweis: 'ResetPassword' in CheckInAction.Actions entspricht der Option 'Passwortrotation' in der Benutzeroberfläche.

Beispiel 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

Erstellen Sie einen PAM-Anbieter mit einer bestehenden Kontolebenszyklus-Richtlinie. Source wird automatisch auf Custom gesetzt.

Parameter

-PolicyID

Die ID einer bestehenden Kontolebenszyklus-Richtlinie. Die neue Richtlinie verwendet die Einstellungen dieser Richtlinie. Die Source der zurückgegebenen Richtlinie wird automatisch auf Custom gesetzt.

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

Der Richtlinientyp (Default oder Custom). Dies setzt das Feld PolicyID des zurückgegebenen Objekts auf einen entsprechenden Wert.

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

Die Richtlinienquelle (Default, Custom oder 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

Dieses Cmdlet unterstützt die gemeinsamen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

RemoteDesktopManager.PowerShellModule.Private.models.PSAccountLifecyclePolicyInfo

Hinweise

Für weitere Informationen geben Sie "Get-Help New-DSAccountLifecyclePolicyInfo -detailed" ein. Für technische Informationen geben Sie "Get-Help New-DSAccountLifecyclePolicyInfo -full" ein.