Set-AzureServiceRemoteDesktopExtension
Habilita a extensão da área de trabalho remota em funções especificadas ou em todas as funções em um serviço implantado ou na implantação.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.
Importante
Os Serviços de Nuvem (clássicos) agora foram preteridos para novos clientes e serão desativados em 31 de agosto de 2024 para todos os clientes. Novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido).
Syntax
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>]
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
O cmdlet Set-AzureServiceRemoteDesktopExtension habilita a extensão de área de trabalho remota em funções especificadas ou em todas as funções em um serviço implantado ou na implantação.
Exemplos
Exemplo 1: Ativar a extensão de área de trabalho remota
PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds
Este comando habilita a extensão de área de trabalho remota para o serviço especificado.
Exemplo 2: Habilitar a extensão de área de trabalho remota para uma função especificada
PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"
Este comando habilita a extensão da área de trabalho remota para o serviço e a função especificados.
Parâmetros
-CertificateThumbprint
Especifica uma impressão digital de certificado a ser usada para criptografar a configuração privada. Esse certificado já deve existir no armazenamento de certificados. Se você não especificar um certificado, esse cmdlet criará um certificado.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Especifica as credenciais a serem habilitadas para a área de trabalho remota. As credenciais incluem um nome de utilizador e uma palavra-passe.
Type: | PSCredential |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Expiration
Especifica um objeto de data e hora que permite ao usuário especificar quando a conta de usuário expira.
Type: | DateTime |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionId
Especifica a ID da extensão.
Type: | String |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Especifica uma variável de informação.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Role
Especifica uma matriz opcional de funções para as quais especificar a configuração da área de trabalho remota. Se esse parâmetro não for especificado, a configuração da área de trabalho remota será aplicada como a configuração padrão para todas as funções.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Especifica o nome do serviço do Azure da implantação.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Especifica o ambiente da implantação a ser modificado. Os valores aceitáveis para este parâmetro são: Produção, Preparo.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThumbprintAlgorithm
Especifica um algoritmo de hash de impressão digital que é usado com a impressão digital para identificar o certificado. Este parâmetro é opcional e o padrão é sha1.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Especifica a versão da extensão.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-X509Certificate
Especifica um certificado x509 que é carregado automaticamente no serviço de nuvem e usado para criptografar a configuração privada da extensão.
Type: | X509Certificate2 |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |