Set-SPManagedAccount

模块:

sharepoint-server

适用于:

SharePoint Server Subscription Edition

配置管理帐户。

语法

Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   -ConfirmPassword <SecureString>
   -NewPassword <SecureString>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-SetNewPassword]
   [-WhatIf]
   [<CommonParameters>]

Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   -ExistingPassword <SecureString>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-UseExistingPassword]
   [-WhatIf]
   [<CommonParameters>]

Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   -Password <SecureString>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AutoGeneratePassword]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-WhatIf]
   [<CommonParameters>]

说明

此 cmdlet 包含多个参数集。 只能使用一个参数集中的参数，而不能结合使用不同参数集中的参数。 若要详细了解如何使用参数集，请参阅 Cmdlet 参数集。

cmdlet Set-SPManagedAccount 设置给定托管帐户的属性。

您可以使用此 cmdlet 更改管理帐户的密码过期和通知设置：使用默认参数集。 此外，还可以使用此 cmdlet 更改管理帐户的密码以根据设置的计划自动生成密码：使用包括 AutoGeneratePassword 参数的参数集。 还可以使用此 cmdlet 将管理帐户的密码更改为管理员已知的新值：使用包括 SetNewPassword 参数的参数集。 最后，可以使用此 cmdlet 将管理帐户的密码更改为已在 Active Directory 域服务 (AD DS) 中更改过的现有值：使用包括 UseExistingPassword 参数的参数集。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

------------------示例-----------------------

$m = Get-SPManagedAccount -Identity "DOMAINx\UserY"
Set-SPManagedAccount -Identity $m -AutoGeneratePassword true

此示例显示显式托管帐户（如果存在），然后尝试将其更新为使用自动生成的密码。

参数

-AssignmentCollection

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。 如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AutoGeneratePassword

自动生成新密码。

键入的值必须是下列值之一：

• True
• False

默认值为 False。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

执行命令前，看到确认提示。 有关详细信息，请键入以下命令：get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ConfirmPassword

确认此管理帐户的新密码。

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-EmailNotification

指定要开始电子邮件通知而进行密码更改之前的天数。

默认值为 5。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ExistingPassword

将此管理帐户的密码设置为已在 Active Directory 域服务 (AD DS) 中更改过的现有值。

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

指定要检索的管理帐户的全名或部分名称。

键入的值必须是有效帐户名称（格式为 Domain\User）或 GUID（格式为 1234-3456-09876）。

Type:	SPManagedAccountPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-NewPassword

设置管理帐户的新密码。

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Password

设置管理帐户的密码。

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-PreExpireDays

指定要计划密码更改到期之前的天数。

默认值为 2。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Schedule

指定要运行密码更改作业的新计划。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SetNewPassword

将密码设置为传入的新值并更改 AD DS 中的值。

键入的值必须是下列值之一：

• True
• False

默认值为 False。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-UseExistingPassword

将密码设置为传入的新值，其中值已在 AD DS 中更改。

键入的值必须是下列值之一：

• True
• False

默认值为 False。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

显示一条描述命令作用的消息，而不执行命令。 有关详细信息，请键入以下命令：get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition