Export-SPCertificate

참조

모듈:: sharepoint-server

SharePoint 팜에서 인증서를 내보냅니다.

Syntax

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Password <SecureString>
      [-EncryptionType <String>]
      [-IncludeAllCertificatesInCertificationPath]
      [-NoExtendedProperties]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Type <String>
      [-IncludeAllCertificatesInCertificationPath]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

SharePoint 팜의 인증서를 인증서 파일로 내보냅니다. 이 내보낸 인증서 파일은 기본적으로 중앙 관리 사이트에 저장되지만 Path 매개 변수로 지정된 경로에도 저장할 수 있습니다.

SharePoint는 인증서를 PFX(PKCS #12) 파일, PKCS #7(PKCS #7) 파일 및 CER 파일로 내보내는 것을 지원합니다. PFX 파일과 P7B 파일 모두 여러 인증서를 포함할 수 있습니다. 이 인증서는 최종 엔터티(리프) 인증서에서 루트 인증서로 인증서 체인을 내보내는 데 유용합니다. 그러나 서버 인증서를 IIS 웹 사이트에 할당하는 데 필요한 인증서에 대한 프라이빗 키는 PFX 파일만 포함할 수 있습니다. CER 파일에는 단일 인증서만 포함됩니다.

예제

------------EXAMPLE 1-----------

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Export-SPCertificate -Identity "Team Sites Certificate" -Password $password -IncludeAllCertificatesInCertificationPath -Path "\\server\fileshare\certificates.pfx"

다음은 "팀 사이트 인증서" 인증서와 해당 프라이빗 키뿐만 아니라 인증서 체인의 다른 인증서를 \\server\fileshare\certificates.pfx 파일로 내보내는 예제입니다.

------------EXAMPLE 2-----------

Export-SPCertificate -Identity "Team Sites Certificate" -Type Cert

다음은 중앙 관리에 저장된 인증서 파일로 "팀 사이트 인증서" 인증서를 내보내는 예제입니다.

매개 변수

-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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionType

내보낸 PFX 파일을 보호하는 데 사용할 암호화 알고리즘을 지정합니다. AES256은 SHA256 해시를 사용한 AES-256 암호화가 사용되도록 지정합니다. TripleDes는 SHA1 해시를 사용한 3DES 암호화를 사용하도록 지정합니다. AES-256 암호화는 3DES 암호화보다 강력하지만 Windows Server 2019 및 최신 운영 체제의 PFX 파일에서만 지원됩니다. PFX 파일이 이전 운영 체제와 호환되어야 하는 경우 3DES 암호화를 사용합니다. 이 매개 변수를 지정하지 않으면 기본적으로 AES-256 암호화가 사용됩니다. 이 매개 변수는 PFX 파일과만 호환됩니다.

Type:	String
Accepted values:	AES256, TripleDes
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

지정된 경로에 이미 있는 경우 파일을 덮어쓰도록 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

내보낼 인증서입니다.

Type:	SPServerCertificatePipeBind
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeAllCertificatesInCertificationPath

지정된 인증서의 인증서 체인에 포함된 추가 인증서를 내보낼지 여부를 지정합니다. 이렇게 하면 지정된 인증서에서 발급한 자식 인증서가 아니라 지정된 인증서의 부모 인증서만 추가됩니다. 이 매개 변수는 PFX 및 P7B 파일과만 호환됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoExtendedProperties

인증서의 이름처럼 인증서의 확장 속성을 내보내지 않아야 하는지 여부를 지정합니다. 이 매개 변수는 PFX 파일과만 호환됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

내보낸 PFX 파일을 보호하는 데 사용할 암호입니다. 이 매개 변수는 PFX 파일과만 호환됩니다.

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

인증서를 내보내야 하는 PFX, P7B 또는 CER 파일의 경로입니다.

또한 인증서는 이 매개 변수가 지정되었는지 여부에 관계없이 중앙 관리에 저장된 인증서 파일로 내보내집니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

생성할 파일의 형식을 지정합니다. Cert는 단일 DER로 인코딩된 인증서를 포함하는 CER 파일을 생성합니다. Pkcs7은 하나 이상의 인증서를 포함하는 PKCS #7(P7B) 파일을 생성합니다. 이 매개 변수는 CER 및 P7B 파일과만 호환됩니다.

Type:	String
Accepted values:	Cert, Pkcs7
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False