New-AzureServiceRemoteDesktopExtensionConfig
展開用のリモート デスクトップ拡張機能の構成を生成します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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
プライベート構成の暗号化に使用する証明書の拇印を指定します。 この証明書は、証明書ストアに既に存在している必要があります。 証明書を指定しない場合、このコマンドレットは証明書を作成します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Credential
リモート デスクトップで有効にする資格情報を指定します。 資格情報には、ユーザー名とパスワードが含まれます。
| 型: | PSCredential |
| 配置: | 3 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Expiration
ユーザー アカウントの有効期限を 指定できる DateTime オブジェクトを指定します。
| 型: | DateTime |
| 配置: | 4 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ExtensionId
拡張 ID を指定します。
| 型: | String |
| 配置: | 6 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
| 型: | ActionPreference |
| Aliases: | infa |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
| 型: | String |
| Aliases: | iv |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| 型: | AzureSMProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Role
リモート デスクトップ構成を指定するロールの配列を省略可能に指定します。 このパラメーターが指定されていない場合、リモート デスクトップ構成はすべてのロールの既定の構成として適用されます。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ThumbprintAlgorithm
拇印を使用して証明書を識別する拇印ハッシュ アルゴリズムを指定します。 このパラメーターは省略可能で、既定値は sha1 です。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Version
拡張機能のバージョンを指定します。
| 型: | String |
| 配置: | 5 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-X509Certificate
指定された場合にクラウド サービスに自動的にアップロードされ、拡張機能のプライベート構成の暗号化に使用される x509 証明書を指定します。
| 型: | X509Certificate2 |
| 配置: | 1 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |