다음을 통해 공유


New-AzureServiceExtensionConfig

배포에 대한 클라우드 서비스 확장 구성을 만듭니다.

참고 항목

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

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

구문

New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-ExtensionId] <String>
   [-ExtensionState] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

New-AzureServiceExtensionConfig cmdlet은 배포에 대한 클라우드 서비스 확장 구성을 만듭니다.

예제

예제 1: 확장 구성 만들기

PS C:\> New-AzureServiceExtensionConfig -ExtensionName 'RDP' -Version '1.0' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

이 명령은 확장 구성을 지정합니다.

예제 2: 역할에 대한 확장 구성 만들기

PS C:\> New-AzureServiceExtensionConfig -Role WebRole1 -ExtensionName 'RDP' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

이 명령은 WebRole1 역할에 대한 확장 구성을 지정합니다.

매개 변수

-CertificateThumbprint

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

형식:String
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ExtensionId

확장의 이름을 지정합니다.

형식:String
Position:8
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ExtensionName

확장의 이름을 지정합니다.

형식:String
Position:3
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ExtensionState

확장의 상태를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 사용
  • 사용 안 함
  • 제거
형식:String
Position:2
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-InformationAction

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

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

  • 계속
  • 무시
  • 묻다
  • SilentlyContinue
  • 중지
  • 일시 중단됨
형식:ActionPreference
별칭:infa
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InformationVariable

정보 변수를 지정합니다.

형식:String
별칭:iv
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PrivateConfiguration

프라이빗 구성 텍스트를 지정합니다.

형식:String
Position:6
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Profile

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

형식:AzureSMProfile
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProviderNamespace

확장의 공급자 네임스페이스를 지정합니다.

형식:String
Position:4
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PublicConfiguration

공용 구성 텍스트를 지정합니다.

형식:String
Position:5
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Role

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

형식:String[]
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ThumbprintAlgorithm

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

형식:String
Position:2
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Version

확장 버전을 지정합니다.

형식:String
Position:7
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-X509Certificate

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

형식:X509Certificate2
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False