New-AzWvdHostPool

Syntaxe

CreateExpanded (Par défaut)

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -HostPoolType <String>
    -LoadBalancerType <String>
    -Location <String>
    -PreferredAppGroupType <String>
    [-SubscriptionId <String>]
    [-AgentUpdateMaintenanceWindow <IMaintenanceWindowProperties[]>]
    [-AgentUpdateMaintenanceWindowTimeZone <String>]
    [-AgentUpdateType <String>]
    [-AgentUpdateUseSessionHostLocalTime]
    [-CustomRdpProperty <String>]
    [-Description <String>]
    [-ExpirationTime <DateTime>]
    [-FriendlyName <String>]
    [-IdentityType <String>]
    [-Kind <String>]
    [-ManagedBy <String>]
    [-MaxSessionLimit <Int32>]
    [-PersonalDesktopAssignmentType <String>]
    [-PlanName <String>]
    [-PlanProduct <String>]
    [-PlanPromotionCode <String>]
    [-PlanPublisher <String>]
    [-PlanVersion <String>]
    [-PublicNetworkAccess <String>]
    [-RegistrationInfoToken <String>]
    [-RegistrationTokenOperation <String>]
    [-Ring <Int32>]
    [-SkuCapacity <Int32>]
    [-SkuFamily <String>]
    [-SkuName <String>]
    [-SkuSize <String>]
    [-SkuTier <String>]
    [-SsoClientId <String>]
    [-SsoClientSecretKeyVaultPath <String>]
    [-SsoSecretType <String>]
    [-SsoadfsAuthority <String>]
    [-StartVMOnConnect]
    [-Tag <Hashtable>]
    [-VMTemplate <String>]
    [-ValidationEnvironment]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullScenarioCreate

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -HostPoolType <String>
    -LoadBalancerType <String>
    -Location <String>
    -PreferredAppGroupType <String>
    [-SubscriptionId <String>]
    [-DesktopAppGroupName <String>]
    [-WorkspaceName <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemples

Exemple 1 : Créer un pool d’hôtes Windows Virtual Desktop par nom

New-AzWvdHostPool -ResourceGroupName ResourceGroupName `
                            -Name HostPoolName `
                            -Location 'eastus' `
                            -HostPoolType 'Pooled' `
                            -LoadBalancerType 'DepthFirst' `
                            -RegistrationTokenOperation 'Update' `
                            -ExpirationTime $((Get-Date).ToUniversalTime().AddDays(1).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ')) `
                            -Description 'Description' `
                            -FriendlyName 'Friendly Name' `
                            -MaxSessionLimit 5 `
                            -VMTemplate $null `
                            -SsoClientId $null `
                            -SsoClientSecretKeyVaultPath $null `
                            -SsoSecretType $null `
                            -SsoadfsAuthority $null `
                            -CustomRdpProperty $null `
                            -Ring $null `
                            -ValidationEnvironment:$false

Location   Name                 Type
--------   ----                 ----
eastus     HostPoolName Microsoft.DesktopVirtualization/hostpools

Exemple 2 : Créer un hostPool Windows Virtual Desktop par nom

New-AzWvdHostPool -ResourceGroupName ResourceGroupName `
                            -Name HostPoolName `
                            -Location 'eastus' `
                            -HostPoolType 'Personal' `
                            -LoadBalancerType 'Persistent' `
                            -RegistrationTokenOperation 'Update' `
                            -ExpirationTime $((Get-Date).ToUniversalTime().AddDays(1).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ')) `
                            -Description 'Description' `
                            -FriendlyName 'Friendly Name' `
                            -MaxSessionLimit 5 `
                            -VMTemplate $null `
                            -SsoClientId $null `
                            -SsoClientSecretKeyVaultPath $null `
                            -SsoSecretType $null `
                            -SsoadfsAuthority $null `
                            -CustomRdpProperty $null `
                            -Ring $null `
                            -ValidationEnvironment:$false

Location   Name                 Type
--------   ----                 ----
eastus     HostPoolName Microsoft.DesktopVirtualization/hostpools

Paramètres

-AgentUpdateMaintenanceWindow

Liste des fenêtres de maintenance. Les fenêtres de maintenance sont longues de 2 heures.

Propriétés du paramètre

Jeux de paramètres

-AgentUpdateMaintenanceWindowTimeZone

Fuseau horaire pour la maintenance tel que défini dans https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Doit être défini si useLocalTime a la valeur true.

Propriétés du paramètre

Jeux de paramètres

-AgentUpdateType

Type de maintenance pour les composants hôtes de session.

Propriétés du paramètre

Jeux de paramètres

-AgentUpdateUseSessionHostLocalTime

Indique s’il faut utiliser localTime de la machine virtuelle.

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-CustomRdpProperty

Propriété rdp personnalisée de HostPool.

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Propriétés du paramètre

Jeux de paramètres

-Description

Description de HostPool.

Propriétés du paramètre

Jeux de paramètres

-DesktopAppGroupName

Nom du groupe d’applications de bureau

Propriétés du paramètre

Jeux de paramètres

-ExpirationTime

Délai d’expiration du jeton d’inscription.

Propriétés du paramètre

Jeux de paramètres

-FriendlyName

Nom convivial de HostPool.

Propriétés du paramètre

Jeux de paramètres

-HostPoolType

Type HostPool pour le bureau.

Propriétés du paramètre

Jeux de paramètres

-IdentityType

Type d’identité.

Propriétés du paramètre

Jeux de paramètres

-JsonFilePath

Chemin d’accès du fichier Json fourni à l’opération Créer

Propriétés du paramètre

Jeux de paramètres

-JsonString

Chaîne Json fournie à l’opération Create

Propriétés du paramètre

Jeux de paramètres

-Kind

Métadonnées utilisées par le portail/l’outil/etc pour afficher différentes expériences d’expérience utilisateur pour les ressources du même type. Par exemple, ApiApps est un type de Microsoft.Web/sites. Si elle est prise en charge, le fournisseur de ressources doit valider et conserver cette valeur.

Propriétés du paramètre

Jeux de paramètres

-LoadBalancerType

Type de l’équilibreur de charge.

Propriétés du paramètre

Jeux de paramètres

-Location

Emplacement géographique où réside la ressource

Propriétés du paramètre

Jeux de paramètres

-ManagedBy

ID de ressource complet de la ressource qui gère cette ressource. Indique si cette ressource est gérée par une autre ressource Azure. S’il est présent, le déploiement en mode complet ne supprime pas la ressource si elle est supprimée du modèle, car elle est gérée par une autre ressource.

Propriétés du paramètre

Jeux de paramètres

-MaxSessionLimit

Limite de session maximale de HostPool.

Propriétés du paramètre

Jeux de paramètres

-Name

Nom du pool d’hôtes dans le groupe de ressources spécifié

Propriétés du paramètre

Jeux de paramètres

-PersonalDesktopAssignmentType

Type PersonalDesktopAssignment pour HostPool.

Propriétés du paramètre

Jeux de paramètres

-PlanName

Nom défini par l’utilisateur de l’artefact tiers en cours d’acquisition.

Propriétés du paramètre

Jeux de paramètres

-PlanProduct

Artefact tiers en cours d’acquisition. Par exemple, NewRelic. Le produit est mappé à l’Id d’offre spécifié pour l’artefact au moment de l’intégration de Data Market.

Propriétés du paramètre

Jeux de paramètres

-PlanPromotionCode

Un éditeur a fourni un code de promotion comme provisionné dans Data Market pour le produit/artefact indiqué.

Propriétés du paramètre

Jeux de paramètres

-PlanPublisher

Éditeur de l’artefact tiers acheté. Par exemple, NewRelic

Propriétés du paramètre

Jeux de paramètres

-PlanVersion

Version du produit/artefact souhaité.

Propriétés du paramètre

Jeux de paramètres

-PreferredAppGroupType

Type de groupe d’applications préféré, par défaut pour le groupe d’applications de bureau

Propriétés du paramètre

Jeux de paramètres

-PublicNetworkAccess

Activé permet à cette ressource d’être accessible à partir de réseaux publics et privés, désactivé permet d’accéder à cette ressource uniquement via des points de terminaison privés

Propriétés du paramètre

Jeux de paramètres

-RegistrationInfoToken

Chaîne encodée en base64 du jeton d’inscription.

Propriétés du paramètre

Jeux de paramètres

-RegistrationTokenOperation

Type de réinitialisation du jeton.

Propriétés du paramètre

Jeux de paramètres

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Propriétés du paramètre

Jeux de paramètres

-Ring

Numéro d’anneau de HostPool.

Propriétés du paramètre

Jeux de paramètres

-SkuCapacity

Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis.

Propriétés du paramètre

Jeux de paramètres

-SkuFamily

Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici.

Propriétés du paramètre

Jeux de paramètres

-SkuName

Nom de la référence SKU. Par exemple P3. Il s’agit généralement d’une lettre+code numérique

Propriétés du paramètre

Jeux de paramètres

-SkuSize

Taille de la référence SKU. Lorsque le champ de nom est la combinaison de niveau et d’une autre valeur, il s’agit du code autonome.

Propriétés du paramètre

Jeux de paramètres

-SkuTier

Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT.

Propriétés du paramètre

Jeux de paramètres

-SsoadfsAuthority

URL du serveur ADFS client pour la signature de certificats WVD SSO.

Propriétés du paramètre

Jeux de paramètres

-SsoClientId

ClientId pour la partie de confiance inscrite utilisée pour émettre des certificats WVD SSO.

Propriétés du paramètre

Jeux de paramètres

-SsoClientSecretKeyVaultPath

Chemin d’accès à Azure KeyVault stockant le secret utilisé pour la communication avec ADFS.

Propriétés du paramètre

Jeux de paramètres

-SsoSecretType

Type d’authentification unique Secret Type.

Propriétés du paramètre

Jeux de paramètres

-StartVMOnConnect

Indicateur permettant d’activer/désactiver la fonctionnalité StartVMOnConnect.

Propriétés du paramètre

Jeux de paramètres

-SubscriptionId

ID de l’abonnement cible. La valeur doit être un UUID.

Propriétés du paramètre

Jeux de paramètres

-Tag

Balises de ressource.

Propriétés du paramètre

Jeux de paramètres

-ValidationEnvironment

Environnement de validation.

Propriétés du paramètre

Jeux de paramètres

-VMTemplate

Modèle de machine virtuelle pour la configuration de sessionhosts dans le pool d’hôtes.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

-WorkspaceName

Nom de l’espace de travail

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Sorties

IHostPool