Request-CsCertificate

구문

Request-CsCertificate -New <SwitchParameter> -Type <CertType[]> [-AllSipDomain <SwitchParameter>] [-CA <String>] [-CaAccount <String>] [-CaPassword <String>] [-City <String>] [-ClientEKU <$true | $false>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-DomainName <String>] [-Force <SwitchParameter>] [-FriendlyName <String>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-KeyAlg <RSA | ECDH_P256 | ECDH_P384 | ECDH_P521>] [-KeySize <Int32>] [-Organization <String>] [-OU <String>] [-Output <String>] [-PrivateKeyExportable <$true | $false>] [-Report <String>] [-State <String>] [-Template <String>] [-WhatIf [<SwitchParameter>]]

Request-CsCertificate -List <SwitchParameter> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-RequestId <Int32>] [-WhatIf [<SwitchParameter>]]

Request-CsCertificate -Retrieve <SwitchParameter> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-RequestId <Int32>] [-WhatIf [<SwitchParameter>]]

Request-CsCertificate -Clear <SwitchParameter> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-RequestId <Int32>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Lync Server 2010에서는 서버 및 서버 역할의 ID를 확인하는 방법으로 인증서를 사용합니다. 예를 들어 에지 서버는 인증서를 사용하여 현재 통신 중인 컴퓨터가 실제 프런트 엔드 서버인지 확인하며, 그 반대의 경우도 마찬가지입니다. Lync Server를 완전히 구현하려면 해당 인증서를 해당 서버 역할에 할당해야 합니다.

Lync Server에서 사용할 인증서를 요청하는 한 가지 방법은 Request-CsCertificate cmdlet을 호출하는 것입니다. Lync Server에서 사용할 인증서를 요청하기 위해 다른 표준 Windows 도구를 사용할 수도 있지만 Request-CsCertificate를 사용할 경우 cmdlet이 CA(인증 기관)에 연결하기 전에 토폴로지를 분석한다는 이점이 있습니다. 이 분석을 기준으로 Request-CsCertificate는 적절한 주체 이름 및 주체 대체 이름 필드가 포함된 인증서를 자동으로 요청합니다.

또한 Request-CsCertificate는 특별히 Lync Server에서 사용할 인증서를 요청하도록 설계되었습니다. 이 cmdlet은 모든 용도에 사용되는 인증서 관리 도구가 아닙니다.

새 인증서 요청 외에도 이 cmdlet을 사용하여 보류 중인 인증서 요청을 검토할 수 있습니다. 단, Request-CsCertificate를 사용하여 요청이 수행된 경우에만 해당합니다. Request-CsCertificate를 사용하여 요청이 수행된 경우 이 cmdlet을 사용하여 보류 중인 인증서 요청을 삭제할 수도 있습니다.

취소한 요청이 있는 경우 인증서 요청을 검색하려고 하면 오류 메시지가 나타날 수 있습니다. Request-CsCertificate는 현재 Issued, Denied 및 Pending 유형의 요청만 지원합니다. 취소한 인증서로 인해 문제가 발생한 경우 다음과 유사한 명령을 사용하여 취소한 요청을 삭제합니다(여기서 224는 취소한 인증서 요청의 RequestID).

Request-CsCertificate –Clear –RequestID 224

그런 다음에는 인증서 요청을 검색할 수 있어야 합니다.

이 cmdlet을 실행할 수 있는 사용자: Request-CsCertificate cmdlet을 로컬로 실행하려면 로컬 관리자이고 지정된 인증 기관에 대한 권한이 있어야 합니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Request-CsCertificate"}

매개 변수

입력 형식

없음. Request-CsCertificate는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

없음. 대신 Request-CsCertificate는 Microsoft.Rtc.Management.Deployment.CertificateReference 개체의 인스턴스를 관리합니다.

예제

-------------------------- 예제 1 -----------------------

Request-CsCertificate -New -Type WebServicesExternal -CA "atl-ca-001.litwareinc.com\myca"

예제 1에 표시된 명령은 CA atl-ca-001.litwareinc.com\myca에 연결하여 새 WebServicesExternal 인증서를 요청하는 새 인증서 요청을 만듭니다.

-------------------------- 예제 2 -----------------------

Request-CsCertificate -List

위 명령은 Request-CsCertificate를 사용하여 수행된 보류 중인 모든 인증서 요청을 표시합니다.

-------------------------- 예제 3 -----------------------

Request-CsCertificate -New -Type WebServicesExternal -Output C:\Certificates\WebServicesExternal.cer

예제 3에서는 Output 매개 변수를 사용하여 오프라인 인증서 요청을 만듭니다.

-------------------------- 예제 4 -----------------------

Request-CsCertificate -New -Type Default,WebServicesInternal,WebServicesExternal -ComputerFqdn "atl-cs-001.litwareinc.com" -CA "atl-ca-001.litwareinc.com\myca" -FriendlyName "Standard Edition Certficate" -Template jcila -PrivateKeyExportable $True -DomainName "atl-cs-001.litwareinc.com,atl-ext.litwareinc.com"

위 예제는 Request-CsCertificate 사용 방법에 대한 보다 구체적이고 현실적인 예입니다. 이 예제에서는 Lync Server Standard Edition에서 사용할 인증서를 요청합니다.

-------------------------- 예제 5 -----------------------

Request-CsCertificate -New -Type Default,WebServicesInternal,WebServicesExternal -ComputerFqdn "atl-cs-001.litwareinc.com" -CA "atl-ca-001.litwareinc.com\myca" -FriendlyName "Enterprise Edition Pool Certificate" -Template jcila -PrivateKeyExportable Ttrue -DomainName "pool1.litwareinc.com,pool1int.litwareinc.com,pool1ext.litwareinc.com"

예제 5에서는 Lync Server Enterprise Edition에서 사용할 풀 인증서를 요청합니다.

-------------------------- 예제 6 -----------------------

Request-CsCertificate -New -Type Internal -ComputerFqdn "atl-edge-001" -CA "atl-ca-001.litwareinc.com\myca" -FriendlyName "Internal Edge Certificate" -Template jcila -PrivateKeyExportable $True -DomainName "atl-edge-001.litwareinc.com, ap.litwareinc.com"

위 예제에서는 내부 에지 서버에 대한 인증서를 요청하는 방법을 보여 줍니다.

-------------------------- 예제 7 -----------------------

Request-CsCertificate -New -Type AccessEdgeExternal,DataEdgeExternal,AudioVideoAuthentication -ComputerFqdn "atl-edge-001" -CA "atl-ca-001.litwareinc.com\myca" -FriendlyName "External Edge Certificate" -Template jcila -PrivateKeyExportable $True -DomainName "atl-edge-001.litwareinc.com,ap.litwareinc.com,dp.litwareinc.com,atl-edge-001"

예제 7은 예제 6에 표시된 명령의 변형입니다. 그러나 이 경우에는 외부 에지 서버에 대해 요청합니다.

참고 항목

기타 리소스

Get-CsCertificate
Import-CsCertificate
Remove-CsCertificate
Set-CsCertificate