Share via


New-AzureServiceRemoteDesktopExtensionConfig

展開用のリモート デスクトップ拡張機能の構成を生成します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

New-AzureServiceRemoteDesktopExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceRemoteDesktopExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

New-AzureServiceRemoteDesktopExtensionConfig コマンドレットは、デプロイ用のリモート デスクトップ拡張機能の構成を生成します。

例 1: リモート デスクトップ拡張機能の構成を生成する

PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred

このコマンドは、指定された資格情報のリモート デスクトップ拡張機能の構成を生成します。

例 2: 指定したロールのリモート デスクトップ拡張機能の構成を生成する

PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred -Role "WebRole01"

このコマンドは、指定された資格情報と WebRole01 ロールのリモート デスクトップ拡張機能の構成を生成します。

パラメーター

-CertificateThumbprint

プライベート構成の暗号化に使用する証明書の拇印を指定します。 この証明書は、証明書ストアに既に存在している必要があります。 証明書を指定しない場合、このコマンドレットは証明書を作成します。

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

-Credential

リモート デスクトップで有効にする資格情報を指定します。 資格情報には、ユーザー名とパスワードが含まれます。

Type:PSCredential
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Expiration

ユーザー アカウントの有効期限を 指定できる DateTime オブジェクトを指定します。

Type:DateTime
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

拡張 ID を指定します。

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

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

-Role

リモート デスクトップ構成を指定するロールの配列を省略可能に指定します。 このパラメーターが指定されていない場合、リモート デスクトップ構成はすべてのロールの既定の構成として適用されます。

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ThumbprintAlgorithm

拇印を使用して証明書を識別する拇印ハッシュ アルゴリズムを指定します。 このパラメーターは省略可能で、既定値は sha1 です。

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

-Version

拡張機能のバージョンを指定します。

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

-X509Certificate

指定された場合にクラウド サービスに自動的にアップロードされ、拡張機能のプライベート構成の暗号化に使用される x509 証明書を指定します。

Type:X509Certificate2
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False