Set-AzureServiceRemoteDesktopExtension

Modul:

Azure

Povolí rozšíření vzdálené plochy pro zadané role nebo všechny role v nasazené službě nebo v nasazení.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Důležité

Služba Cloud Services (Classic) je teď pro nové zákazníky zastaralá a bude vyřazena 31. srpna 2024 pro všechny zákazníky. Nová nasazení by měla používat nový model nasazení založený na Azure Resource Manageru na Azure Cloud Services (rozšířená podpora).

Syntaxe

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

Rutina Set-AzureServiceRemoteDesktopExtension umožňuje rozšíření vzdálené plochy pro zadané role nebo všechny role nasazené služby nebo v nasazení.

Příklady

Příklad 1: Povolení rozšíření vzdálené plochy

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

Tento příkaz povolí rozšíření vzdálené plochy pro zadanou službu.

Příklad 2: Povolení rozšíření vzdálené plochy pro zadanou roli

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

Tento příkaz povolí rozšíření vzdálené plochy pro zadanou službu a roli.

Parametry

-CertificateThumbprint

Určuje kryptografický otisk certifikátu, který se má použít k šifrování privátní konfigurace. Tento certifikát už musí existovat v úložišti certifikátů. Pokud nezadáte certifikát, tato rutina vytvoří certifikát.

Typ:	String
Position:	3
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Credential

Určuje přihlašovací údaje, které se mají povolit pro vzdálenou plochu. Přihlašovací údaje zahrnují uživatelské jméno a heslo.

Typ:	PSCredential
Position:	5
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Expiration

Určuje objekt data a času, který uživateli umožňuje zadat, kdy vyprší platnost uživatelského účtu.

Typ:	DateTime
Position:	6
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ExtensionId

Určuje ID rozšíření.

Typ:	String
Position:	8
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

• Pokračovat
• Ignorovat
• Informovat se
• SilentlyContinue
• Zastavit
• Suspend

Typ:	ActionPreference
Aliasy:	infa
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InformationVariable

Určuje informační proměnnou.

Typ:	String
Aliasy:	iv
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:	AzureSMProfile
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Role

Určuje volitelnou matici rolí, pro které se má zadat konfigurace vzdálené plochy. Pokud tento parametr není zadaný, konfigurace vzdálené plochy se použije jako výchozí konfigurace pro všechny role.

Typ:	String[]
Position:	2
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ServiceName

Určuje název služby Azure nasazení.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Slot

Určuje prostředí nasazení, které se má upravit. Přijatelné hodnoty pro tento parametr jsou: Production, Staging.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ThumbprintAlgorithm

Určuje algoritmus hash kryptografického otisku, který se používá s kryptografickým otiskem k identifikaci certifikátu. Tento parametr je volitelný a výchozí hodnota je sha1.

Typ:	String
Position:	4
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Version

Určuje verzi rozšíření.

Typ:	String
Position:	7
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-X509Certificate

Určuje certifikát x509, který se automaticky nahraje do cloudové služby a používá se k šifrování privátní konfigurace rozšíření.

Typ:	X509Certificate2
Position:	3
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Související odkazy

• Get-AzureServiceRemoteDesktopExtension