New-AzWvdHostPool

Składnia

CreateExpanded (domyślnie)

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>]

Opis

Przykłady

Przykład 1. Tworzenie puli hostów usługi Windows Virtual Desktop według nazwy

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

Przykład 2. Tworzenie puli hostów usługi Windows Virtual Desktop według nazwy

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

Parametry

-AgentUpdateMaintenanceWindow

Lista okien obsługi. Okna obsługi to 2 godziny.

Właściwości parametru

Zestawy parametrów

-AgentUpdateMaintenanceWindowTimeZone

Strefa czasowa konserwacji zdefiniowana w https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Należy ustawić wartość , jeśli parametr useLocalTime ma wartość true.

Właściwości parametru

Zestawy parametrów

-AgentUpdateType

Typ konserwacji składników hosta sesji.

Właściwości parametru

Zestawy parametrów

-AgentUpdateUseSessionHostLocalTime

Czy używać lokalnego czasu maszyny wirtualnej.

Właściwości parametru

Zestawy parametrów

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Zestawy parametrów

-CustomRdpProperty

Niestandardowa właściwość rdp puli hostów.

Właściwości parametru

Zestawy parametrów

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Właściwości parametru

Zestawy parametrów

-Description

Opis puli hostów.

Właściwości parametru

Zestawy parametrów

-DesktopAppGroupName

Nazwa grupy aplikacji klasycznych

Właściwości parametru

Zestawy parametrów

-ExpirationTime

Czas wygaśnięcia tokenu rejestracji.

Właściwości parametru

Zestawy parametrów

-FriendlyName

Przyjazna nazwa puli hostów.

Właściwości parametru

Zestawy parametrów

-HostPoolType

Typ puli hostów dla pulpitu.

Właściwości parametru

Zestawy parametrów

-IdentityType

Typ tożsamości.

Właściwości parametru

Zestawy parametrów

-JsonFilePath

Ścieżka pliku Json dostarczonego do operacji Tworzenia

Właściwości parametru

Zestawy parametrów

-JsonString

Ciąg Json dostarczony do operacji Tworzenia

Właściwości parametru

Zestawy parametrów

-Kind

Metadane używane przez portal/narzędzia/itp. do renderowania różnych środowisk środowiska użytkownika dla zasobów tego samego typu. Np. ApiApps to rodzaj typu Microsoft.Web/sites. Jeśli jest obsługiwana, dostawca zasobów musi zweryfikować i utrwalić tę wartość.

Właściwości parametru

Zestawy parametrów

-LoadBalancerType

Typ modułu równoważenia obciążenia.

Właściwości parametru

Zestawy parametrów

-Location

Lokalizacja geograficzna, w której znajduje się zasób

Właściwości parametru

Zestawy parametrów

-ManagedBy

W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie trybu pełnego nie spowoduje usunięcia zasobu, jeśli zostanie usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób.

Właściwości parametru

Zestawy parametrów

-MaxSessionLimit

Maksymalny limit sesji puli hostów.

Właściwości parametru

Zestawy parametrów

-Name

Nazwa puli hostów w określonej grupie zasobów

Właściwości parametru

Zestawy parametrów

-PersonalDesktopAssignmentType

PersonalDesktopAssignment typ puli hostów.

Właściwości parametru

Zestawy parametrów

-PlanName

Zdefiniowana przez użytkownika nazwa artefaktu innej firmy, który jest pozyskiwany.

Właściwości parametru

Zestawy parametrów

-PlanProduct

Artefakt innej firmy, który jest pozyskiwany. Np. NewRelic. Produkt jest mapowy na wartość OfferID określoną dla artefaktu podczas dołączania do usługi Data Market.

Właściwości parametru

Zestawy parametrów

-PlanPromotionCode

Wydawca dostarczył kod podwyższania poziomu jako zaaprowizowany w usłudze Data Market dla podanego produktu/artefaktu.

Właściwości parametru

Zestawy parametrów

-PlanPublisher

Wydawca zakupionego artefaktu innej firmy. Np. NewRelic

Właściwości parametru

Zestawy parametrów

-PlanVersion

Wersja żądanego produktu/artefaktu.

Właściwości parametru

Zestawy parametrów

-PreferredAppGroupType

Typ preferowanej grupy aplikacji, domyślnie to Grupa aplikacji klasycznych

Właściwości parametru

Zestawy parametrów

-PublicNetworkAccess

Włączone umożliwia dostęp do tego zasobu zarówno z sieci publicznych, jak i prywatnych. Opcja Wyłączone umożliwia dostęp do tego zasobu tylko za pośrednictwem prywatnych punktów końcowych

Właściwości parametru

Zestawy parametrów

-RegistrationInfoToken

Ciąg zakodowany w tokenie rejestracji base64.

Właściwości parametru

Zestawy parametrów

-RegistrationTokenOperation

Typ resetowania tokenu.

Właściwości parametru

Zestawy parametrów

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Właściwości parametru

Zestawy parametrów

-Ring

Numer pierścienia puli hostów.

Właściwości parametru

Zestawy parametrów

-SkuCapacity

Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte.

Właściwości parametru

Zestawy parametrów

-SkuFamily

Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.

Właściwości parametru

Zestawy parametrów

-SkuName

Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą

Właściwości parametru

Zestawy parametrów

-SkuSize

Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod.

Właściwości parametru

Zestawy parametrów

-SkuTier

To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put.

Właściwości parametru

Zestawy parametrów

-SsoadfsAuthority

Adres URL serwera usług AD FS klienta do podpisywania certyfikatów logowania jednokrotnego WVD.

Właściwości parametru

Zestawy parametrów

-SsoClientId

ClientId zarejestrowanej jednostki uzależnionej używanej do wystawiania certyfikatów logowania jednokrotnego WVD.

Właściwości parametru

Zestawy parametrów

-SsoClientSecretKeyVaultPath

Ścieżka do usługi Azure KeyVault przechowując wpis tajny używany do komunikacji z usługami ADFS.

Właściwości parametru

Zestawy parametrów

-SsoSecretType

Typ logowania jednokrotnego w typie wpisu tajnego.

Właściwości parametru

Zestawy parametrów

-StartVMOnConnect

Flaga włączania/wyłączania funkcji StartVMOnConnect.

Właściwości parametru

Zestawy parametrów

-SubscriptionId

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

Właściwości parametru

Zestawy parametrów

-Tag

Tagi zasobów.

Właściwości parametru

Zestawy parametrów

-ValidationEnvironment

To środowisko weryfikacji.

Właściwości parametru

Zestawy parametrów

-VMTemplate

Szablon maszyny wirtualnej dla konfiguracji hostów sesji w puli hostów.

Właściwości parametru

Zestawy parametrów

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Zestawy parametrów

-WorkspaceName

Nazwa obszaru roboczego

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wyjściowe

IHostPool