Set-SPManagedAccount

  • 參考
模組:
sharepoint-server
適用於:
SharePoint Server Subscription Edition

設定受管理的帳戶。

Syntax

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>]

Description

此 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 參數，將會自動處置這些物件。

使用 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 的有效帳戶名稱，或格式為 1234-3456-09876 的 GUID。

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