다음을 통해 공유

Set-AzureServiceRemoteDesktopExtension

모듈:
Azure Module

배포된 서비스 또는 배포 시 지정된 역할 또는 모든 역할에 대해 원격 데스크톱 확장을 사용하도록 설정합니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

Important

신규 고객에게는 Cloud Services(클래식)가 사용되지 않으며 모든 고객에 대해 2024년 8월 31일에 사용 중지됩니다. 새 배포에서는 새로운 Azure Resource Manager 기반 배포 모델인 Azure Cloud Services(추가 지원)를 사용해야 합니다.

구문

SetExtension (기본값) 

Set-AzureServiceRemoteDesktopExtension
    [[-ServiceName] <String>]
    [[-Slot] <String>]
    [[-Role] <String[]>]
    [[-X509Certificate] <X509Certificate2>]
    [[-ThumbprintAlgorithm] <String>]
    [-Credential] <PSCredential>
    [[-Expiration] <DateTime>]
    [[-Version] <String>]
    [[-ExtensionId] <String>]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

SetExtensionUsingThumbprint 

Set-AzureServiceRemoteDesktopExtension
    [[-ServiceName] <String>]
    [[-Slot] <String>]
    [[-Role] <String[]>]
    [-CertificateThumbprint] <String>
    [[-ThumbprintAlgorithm] <String>]
    [-Credential] <PSCredential>
    [[-Expiration] <DateTime>]
    [[-Version] <String>]
    [[-ExtensionId] <String>]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

Description

Set-AzureServiceRemoteDesktopExtension cmdlet을 사용하면 배포된 서비스 또는 배포 시 지정된 역할 또는 모든 역할에 대해 원격 데스크톱 확장을 사용할 수 있습니다.

예제

예제 1: 원격 데스크톱 확장 사용

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds

이 명령은 지정된 서비스에 대해 원격 데스크톱 확장을 사용하도록 설정합니다.

예제 2: 지정된 역할에 대해 원격 데스크톱 확장 사용

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"

이 명령은 지정된 서비스 및 역할에 대해 원격 데스크톱 확장을 사용하도록 설정합니다.

매개 변수

-CertificateThumbprint

프라이빗 구성을 암호화하는 데 사용할 인증서 지문을 지정합니다. 이 인증서는 인증서 저장소에 이미 있어야 합니다. 인증서를 지정하지 않으면 이 cmdlet은 인증서를 만듭니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetExtensionUsingThumbprint
Position:3
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Credential

원격 데스크톱에 사용할 자격 증명을 지정합니다. 자격 증명에는 사용자 이름 및 암호가 포함됩니다.

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:5
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Expiration

사용자가 사용자 계정이 만료되는 시기를 지정할 수 있는 날짜 시간 개체를 지정합니다.

매개 변수 속성

형식:DateTime
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:6
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ExtensionId

확장 ID를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:8
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 묻다
  • SilentlyContinue
  • 중지
  • 일시 중단됨

매개 변수 속성

형식:ActionPreference
Default value:None
와일드카드 지원:False
DontShow:False
별칭:infa

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InformationVariable

정보 변수를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:iv

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

매개 변수 속성

형식:AzureSMProfile
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Role

원격 데스크톱 구성을 지정할 역할의 선택적 배열을 지정합니다. 이 매개 변수를 지정하지 않으면 원격 데스크톱 구성이 모든 역할에 대한 기본 구성으로 적용됩니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ServiceName

배포의 Azure 서비스 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Slot

수정할 배포 환경을 지정합니다. 이 매개 변수에 허용되는 값은 프로덕션, 스테이징입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ThumbprintAlgorithm

지문과 함께 인증서를 식별하는 데 사용되는 지문 해시 알고리즘을 지정합니다. 이 매개 변수는 선택 사항이며 기본값은 sha1입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:4
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Version

확장 버전을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:7
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-X509Certificate

클라우드 서비스에 자동으로 업로드되고 확장의 프라이빗 구성을 암호화하는 데 사용되는 x509 인증서를 지정합니다.

매개 변수 속성

형식:X509Certificate2
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetExtension
Position:3
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.