Set-AzureServiceRemoteDesktopExtension
Hiermee schakelt u de extensie extern bureaublad in voor opgegeven rollen of alle rollen in een geïmplementeerde service of bij de implementatie.
Notitie
De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.
De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.
Belangrijk
Cloud Services (klassiek) is nu afgeschaft voor nieuwe klanten en wordt op 31 augustus 2024 buiten gebruik gesteld voor alle klanten. Nieuwe implementaties moeten gebruikmaken van het nieuwe op Azure Resource Manager gebaseerde implementatiemodel Azure Cloud Services (uitgebreide ondersteuning).
Syntaxis
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
Met de cmdlet Set-AzureServiceRemoteDesktopExtension kunt u extern bureaublad-extensie inschakelen voor opgegeven rollen of alle rollen in een geïmplementeerde service of bij implementatie.
Voorbeelden
Voorbeeld 1: Extern bureaublad-extensie inschakelen
PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds
Met deze opdracht wordt de extern bureaublad-extensie voor de opgegeven service ingeschakeld.
Voorbeeld 2: Extern bureaublad-extensie inschakelen voor een opgegeven rol
PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"
Met deze opdracht wordt de extern-bureaubladextensie ingeschakeld voor de opgegeven service en rol.
Parameters
-CertificateThumbprint
Hiermee geeft u een certificaatvingerafdruk op die moet worden gebruikt om de persoonlijke configuratie te versleutelen. Dit certificaat moet al aanwezig zijn in het certificaatarchief. Als u geen certificaat opgeeft, maakt deze cmdlet een certificaat.
Type: | String |
Position: | 3 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Credential
Hiermee geeft u de referenties op die moeten worden ingeschakeld voor extern bureaublad. Referenties bevatten een gebruikersnaam en wachtwoord.
Type: | PSCredential |
Position: | 5 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Expiration
Hiermee geeft u een datum/tijd-object op waarmee de gebruiker kan opgeven wanneer het gebruikersaccount verloopt.
Type: | DateTime |
Position: | 6 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ExtensionId
Hiermee geeft u de extensie-id.
Type: | String |
Position: | 8 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-InformationAction
Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.
De aanvaardbare waarden voor deze parameter zijn:
- Verdergaan
- Negeren
- Vragen
- SilentlyContinue
- Stoppen
- Onderbreken
Type: | ActionPreference |
Aliassen: | infa |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-InformationVariable
Hiermee geeft u een informatievariabele op.
Type: | String |
Aliassen: | iv |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Profile
Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Role
Hiermee geeft u een optionele matrix van rollen op waarvoor de configuratie van het externe bureaublad moet worden opgegeven. Als deze parameter niet is opgegeven, wordt de configuratie van het extern bureaublad toegepast als de standaardconfiguratie voor alle rollen.
Type: | String[] |
Position: | 2 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ServiceName
Hiermee geeft u de Azure-servicenaam van de implementatie op.
Type: | String |
Position: | 0 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Slot
Hiermee geeft u de omgeving van de implementatie die moet worden gewijzigd. De acceptabele waarden voor deze parameter zijn: Productie, Fasering.
Type: | String |
Position: | 1 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ThumbprintAlgorithm
Hiermee geeft u een hash-algoritme voor vingerafdruk op dat wordt gebruikt met de vingerafdruk om het certificaat te identificeren. Deze parameter is optioneel en de standaardwaarde is sha1.
Type: | String |
Position: | 4 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Version
Hiermee geeft u de extensieversie.
Type: | String |
Position: | 7 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-X509Certificate
Hiermee geeft u een x509-certificaat op dat automatisch wordt geüpload naar de cloudservice en wordt gebruikt voor het versleutelen van de persoonlijke configuratie van de extensie.
Type: | X509Certificate2 |
Position: | 3 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |