Dela via


Set-AzureServiceRemoteDesktopExtension

Aktiverar fjärrskrivbordstillägg på angivna roller eller alla roller i en distribuerad tjänst eller vid distribution.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

Viktigt!

Cloud Services (klassisk) är nu inaktuellt för nya kunder och kommer att dras tillbaka den 31 augusti 2024 för alla kunder. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).

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

Cmdleten Set-AzureServiceRemoteDesktopExtension aktiverar fjärrskrivbordstillägg för angivna roller eller alla roller i en distribuerad tjänst eller vid distribution.

Exempel

Exempel 1: Aktivera fjärrskrivbordstillägg

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds

Det här kommandot aktiverar fjärrskrivbordstillägget för den angivna tjänsten.

Exempel 2: Aktivera fjärrskrivbordstillägg för en angiven roll

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"

Det här kommandot aktiverar fjärrskrivbordstillägget för den angivna tjänsten och rollen.

Parametrar

-CertificateThumbprint

Anger ett tumavtryck för certifikat som ska användas för att kryptera den privata konfigurationen. Certifikatet måste redan finnas i certifikatarkivet. Om du inte anger något certifikat skapar den här cmdleten ett certifikat.

Typ:String
Position:3
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Anger de autentiseringsuppgifter som ska aktiveras för fjärrskrivbord. Autentiseringsuppgifterna innehåller ett användarnamn och lösenord.

Typ:PSCredential
Position:5
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Expiration

Anger ett datumtidsobjekt som gör att användaren kan ange när användarkontot upphör att gälla.

Typ:DateTime
Position:6
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

Anger tilläggs-ID:t.

Typ:String
Position:8
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Typ:ActionPreference
Aliases:infa
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Anger en informationsvariabel.

Typ:String
Aliases:iv
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Role

Anger en valfri matris med roller som du vill ange fjärrskrivbordskonfigurationen för. Om den här parametern inte anges tillämpas konfigurationen för fjärrskrivbord som standardkonfiguration för alla roller.

Typ:String[]
Position:2
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Anger Azure-tjänstnamnet för distributionen.

Typ:String
Position:0
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Slot

Anger den miljö för distributionen som ska ändras. De acceptabla värdena för den här parametern är: Produktion, Mellanlagring.

Typ:String
Position:1
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ThumbprintAlgorithm

Anger en algoritm för tumavtryckshashing som används med tumavtrycket för att identifiera certifikatet. Den här parametern är valfri och standardvärdet är sha1.

Typ:String
Position:4
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Anger tilläggsversionen.

Typ:String
Position:7
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-X509Certificate

Anger ett x509-certifikat som automatiskt laddas upp till molntjänsten och används för att kryptera den privata konfigurationen av tillägget.

Typ:X509Certificate2
Position:3
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False