Compartilhar via

Set-SPManagedAccount

Módulo:
SharePointServer module

Configura a conta gerenciada.

Sintaxe

NewPassword 

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

ExistingPassword 

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

NewPasswordAsParameter 

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

AutoGeneratePassword 

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

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O Set-SPManagedAccount cmdlet define as propriedades na conta gerida especificada.

É possível usar este cmdlet para alterar as configurações de notificação e de expiração de senha da conta gerenciada: use o conjunto de parâmetros padrão. Além disso, é possível usar este cmdlet para alterar a senha da conta gerenciada para gerar senhas automaticamente de acordo com um cronograma definido: use o conjunto de parâmetros que inclui o parâmetro AutoGeneratePassword. Também é possível usar este cmdlet para alterar a senha da conta gerenciada para um novo valor de conhecimento do administrador: use o conjunto de parâmetros que inclui o parâmetro SetNewPassword. Por fim, você pode usar este cmdlet para alterar a senha da conta gerenciada para um valor existente que tenha sido alterado no AD DS (Serviços de Domínio Active Directory): use o conjunto de parâmetros que inclui o parâmetro UseExistingPassword.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO

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

Este exemplo apresenta uma conta gerida explícita se existir e, em seguida, tenta atualizá-la para utilizar palavras-passe geradas automaticamente.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AutoGeneratePassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gera uma nova senha automaticamente.

O tipo deve ser um dos valores a seguir:

  • Verdadeiro
  • Falso

O valor padrão é False.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AutoGeneratePassword
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConfirmPassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Confirma a nova senha da conta gerenciada.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewPassword
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EmailNotification

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o número de dias até a alteração da senha para iniciar as notificações por email.

O valor padrão é 5.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExistingPassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Define a senha desta conta gerenciada para um valor existente que já tenha sido alterado no AD DS.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ExistingPassword
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome completo ou parcial das contas gerenciadas a serem recuperadas.

O tipo deve ser um nome de conta válido, no formato Domain\User, ou um GUID, no formato 1234-3456-09876.

Propriedades do parâmetro

Tipo:SPManagedAccountPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NewPassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Define uma nova senha para a conta gerenciada

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewPassword
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Password

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Define uma senha para a conta gerenciada.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewPasswordAsParameter
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PreExpireDays

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o número de dias até a expiração para agendar a alteração da senha.

O valor padrão é 2.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Schedule

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o novo cronograma de execução do trabalho de alteração de senha.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SetNewPassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Define o novo valor da senha e altera o valor no AD DS.

O tipo deve ser um dos valores a seguir:

  • Verdadeiro
  • Falso

O valor padrão é False.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewPassword
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseExistingPassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Define o novo valor da senha que já tenha sido alterado no AD DS.

O tipo deve ser um dos valores a seguir:

  • Verdadeiro
  • Falso

O valor padrão é False.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ExistingPassword
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.