Partilhar via

Set-AzureServiceRemoteDesktopExtension

Módulo:
Azure Module

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.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

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).

Sintaxe

SetExtension (Predefinição) 

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

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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetExtensionUsingThumbprint
Position:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:5
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Expiration

Especifica um objeto de data e hora que permite ao usuário especificar quando a conta de usuário expira.

Propriedades dos parâmetros

Tipo:DateTime
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ExtensionId

Especifica a ID da extensão.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:8
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:ActionPreference
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Infa

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InformationVariable

Especifica uma variável de informação.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:•

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:AzureSMProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ServiceName

Especifica o nome do serviço do Azure da implantação.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Slot

Especifica o ambiente da implantação a ser modificado. Os valores aceitáveis para este parâmetro são: Produção, Preparo.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Version

Especifica a versão da extensão.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:X509Certificate2
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetExtension
Position:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.