Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo aplica-se a: ✔️ .NET Core 3.1.400 SDK e versões posteriores
Name
dotnet nuget update client-cert - Atualizar a configuração de um certificado cliente para a fonte de um pacote NuGet.
Synopsis
dotnet nuget update client-cert --package-source <SOURCE_NAME>
[--path <CERTIFICATE_PATH>] [--password <PASSWORD>]
[--store-password-in-clear-text] [--configfile <FILE>] [-f|--force]
dotnet nuget update client-cert --package-source <SOURCE_NAME>
[--find-value <VALUE>] [--find-by <FIND_TYPE>]
[--store-location <LOCATION>] [--store-name <STORE_NAME>]
[--configfile <FILE>] [-f|--force]
dotnet nuget update client-cert -h|--help
Description
O dotnet nuget update client-cert comando atualiza a configuração do certificado do cliente que corresponde ao nome de origem do pacote. A configuração já deve existir. Para adicionar uma configuração, use dotnet nuget add client-cert.
Especifique pelo menos uma definição para o tipo de fonte de certificado existente:
-
Ficheiro: Especifique
--path,--password, ou ambos. -
Armazenamento de certificados: Especifique um ou mais de
--store-location,--store-name,--find-by, e--find-value.
As definições que omites mantêm os valores existentes. Por exemplo, para substituir um ficheiro de certificado que utiliza a mesma palavra-passe, especifique apenas --path. Para alterar a forma como uma palavra-passe é armazenada, forneça novamente a palavra-passe com --password; --store-password-in-clear-text alone não atualiza a configuração.
Não combines opções de ficheiro com opções de loja. Não podes mudar uma configuração de ficheiro para uma configuração de loja, ou uma configuração de loja para uma configuração de ficheiros. Para alterar o tipo de origem do certificado, remova a configuração e depois adicione uma nova configuração.
A menos que especifique --force, o NuGet verifica se consegue encontrar e carregar o certificado antes de guardar a configuração. O comando não testa a autenticação com a fonte do pacote.
Opções
-
--configfile <FILE>O arquivo de configuração do NuGet (nuget.config) a ser usado. Se especificado, somente as configurações desse arquivo serão usadas. Se não for especificado, a hierarquia de arquivos de configuração do diretório atual será usada. Para obter mais informações, consulte Configurações comuns do NuGet.
--find-by <FIND_TYPE>O método de pesquisa na loja de certificados. Os valores não são sensíveis a maiúsculas e minúsculas. Use um tipo de busca X.509 sem o
FindByprefixo. Por exemplo, useThumbprintouSubjectName, notFindByThumbprintouFindBySubjectName. Para todos os valores aceites, consulte a opção do comando--find-byde adição.--find-value <VALUE>O valor a procurar na loja de certificados, como a impressão digital do certificado ou o nome do assunto.
-f|--forceGuarda a configuração mesmo que o NuGet não consiga encontrar ou carregar o certificado. Esta opção não desativa a validação do certificado do servidor HTTPS.
-
-?|-h|--helpImprime uma descrição de como usar o comando.
-s|--package-source <SOURCE_NAME>O nome de origem do pacote associado à configuração existente do certificado do cliente. Required. Especifique o nome de origem, não o URL.
--password <PASSWORD>A senha para o arquivo de certificado. Use apenas com uma configuração de ficheiros. Por defeito, o NuGet encripta a palavra-passe antes de a guardar.
Note
A encriptação por palavra-passe é suportada apenas no Windows. Só o mesmo utilizador na mesma máquina pode desencriptar a palavra-passe.
--path <CERTIFICATE_PATH>O caminho para o ficheiro de certificado de substituição.
Para selecionar um ficheiro específico, use um caminho absoluto. Para um caminho relativo, o NuGet verifica primeiro o diretório de trabalho atual. Se o ficheiro não estiver lá, o NuGet verifica o caminho em relação ao diretório que contém o ficheiro de configuração do NuGet.
--store-location <LOCATION>A localização do depósito de certificados:
CurrentUserouLocalMachine.--store-name <STORE_NAME>O nome da loja de certificados. Os valores aceites são
AddressBook,AuthRoot,CertificateAuthority,Disallowed,My,Root,TrustedPeople, eTrustedPublisher. A disponibilidade da loja de certificados depende do seu sistema operativo.--store-password-in-clear-textGuarda a palavra-passe do ficheiro de certificado sem encriptação. Especifique esta opção com
--password. Para guardar uma palavra-passe numa plataforma que não seja o Windows, use esta opção.Warning
Evite palavras-passe em texto claro sempre que possível. Restringa o acesso a ficheiros de configuração que contenham palavras-passe e não comprometa palavras-passe ou chaves privadas no controlo de versão.
Examples
Estes exemplos exigem uma configuração existente de certificado cliente para um código-fonte de pacote chamado Contoso.
Substitua um ficheiro de certificado. Se a substituição usar uma palavra-passe diferente, especifique
--passwordtambém :dotnet nuget update client-cert --package-source Contoso --path .\replacement-client.pfx --configfile .\nuget.configAtualize a configuração de uma loja para usar uma impressão digital diferente do certificado. Substitua
<CERTIFICATE_THUMBPRINT>pela nova impressão digital:dotnet nuget update client-cert --package-source Contoso --find-by Thumbprint --find-value <CERTIFICATE_THUMBPRINT> --configfile .\nuget.config