Compartilhar via


Update-SPSecureStoreMasterKey

Altera a chave mestra de um aplicativo de Serviço do Repositório Seguro.

Sintaxe

Default (Padrão)

Update-SPSecureStoreMasterKey
    -Passphrase <String>
    -ServiceApplicationProxy <SPServiceApplicationProxyPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

Description

O Update-SPSecureStoreApplicationServerKey cmdlet altera a chave de master de uma aplicação do Serviço de Arquivo Seguro.

A atualização da chave mestra é necessária quando:

-- É criada uma nova instância de uma aplicação de serviço e a base de dados da aplicação de serviço Arquivo Seguro é nova ou vazia.

--A chave de master ou frase de acesso foi comprometida.

--As diretrizes de segurança exigem que a frase de acesso ou a chave sejam substituídas.

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

$newPassPhrase = "abcDEF123!"
$proxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq 'Secure Store Service Application Proxy'}
Update-SPSecureStoreMasterKey -ServiceApplicationProxy $proxy -Passphrase $newPassPhrase

Este exemplo cria uma nova chave mestra para o aplicativo de serviço determinado.

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

-Passphrase

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

Especifica a frase de acesso que é utilizada para a base de dados do Arquivo Seguro. A frase de acesso que introduzir não está armazenada. Certifique-se de que anota a frase de acesso e a armazena numa localização segura. A frase de acesso será necessária para adicionar novos servidores de serviço de Arquivo Seguro.

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:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServiceApplicationProxy

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

Especifica o proxy do aplicativo de serviço do Repositório Seguro que contém a chave mestra a ser atualizada.

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
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.