共用方式為


Update-AzWvdHostPool

更新主機集區。

語法

UpdateExpanded (預設值)

Update-AzWvdHostPool
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-AgentUpdateMaintenanceWindow <IMaintenanceWindowPatchProperties[]>]
    [-AgentUpdateMaintenanceWindowTimeZone <String>]
    [-AgentUpdateType <String>]
    [-AgentUpdateUseSessionHostLocalTime]
    [-CustomRdpProperty <String>]
    [-Description <String>]
    [-FriendlyName <String>]
    [-LoadBalancerType <String>]
    [-MaxSessionLimit <Int32>]
    [-PersonalDesktopAssignmentType <String>]
    [-PreferredAppGroupType <String>]
    [-PublicNetworkAccess <String>]
    [-RegistrationInfoExpirationTime <DateTime>]
    [-RegistrationInfoRegistrationTokenOperation <String>]
    [-Ring <Int32>]
    [-SsoClientId <String>]
    [-SsoClientSecretKeyVaultPath <String>]
    [-SsoSecretType <String>]
    [-SsoadfsAuthority <String>]
    [-StartVMOnConnect]
    [-Tag <Hashtable>]
    [-VMTemplate <String>]
    [-ValidationEnvironment]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonString

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

UpdateViaJsonFilePath

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

UpdateViaIdentityExpanded

Update-AzWvdHostPool
    -InputObject <IDesktopVirtualizationIdentity>
    [-AgentUpdateMaintenanceWindow <IMaintenanceWindowPatchProperties[]>]
    [-AgentUpdateMaintenanceWindowTimeZone <String>]
    [-AgentUpdateType <String>]
    [-AgentUpdateUseSessionHostLocalTime]
    [-CustomRdpProperty <String>]
    [-Description <String>]
    [-FriendlyName <String>]
    [-LoadBalancerType <String>]
    [-MaxSessionLimit <Int32>]
    [-PersonalDesktopAssignmentType <String>]
    [-PreferredAppGroupType <String>]
    [-PublicNetworkAccess <String>]
    [-RegistrationInfoExpirationTime <DateTime>]
    [-RegistrationInfoRegistrationTokenOperation <String>]
    [-Ring <Int32>]
    [-SsoClientId <String>]
    [-SsoClientSecretKeyVaultPath <String>]
    [-SsoSecretType <String>]
    [-SsoadfsAuthority <String>]
    [-StartVMOnConnect]
    [-Tag <Hashtable>]
    [-VMTemplate <String>]
    [-ValidationEnvironment]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

更新主機集區。

範例

範例 1:依名稱更新 Windows 虛擬桌面主機集區

Update-AzWvdHostPool -ResourceGroupName ResourceGroupName `
                            -Name HostPoolName `
                            -LoadBalancerType 'BreadthFirst' `
                            -Description 'Description' `
                            -FriendlyName 'Friendly Name' `
                            -MaxSessionLimit 6 `
                            -CustomRdpProperty $null `
                            -Ring $null `
                            -ValidationEnvironment:$false
Location   Name                 Type
--------   ----                 ----
eastus     HostPoolName Microsoft.DesktopVirtualization/hostpools

此命令會更新資源群組中的 Windows 虛擬桌面 HostPool。

參數

-AgentUpdateMaintenanceWindow

維護時段清單。 維護期間長達2小時。

參數屬性

類型:

IMaintenanceWindowPatchProperties[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AgentUpdateMaintenanceWindowTimeZone

維護時區如 中定義 https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0。 如果 useLocalTime 為 true,則必須設定 。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AgentUpdateType

會話主機組件的維護類型。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AgentUpdateUseSessionHostLocalTime

是否要使用虛擬機的localTime。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CustomRdpProperty

HostPool 的自定義 rdp 屬性。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet,請使用 SubscriptionId 參數。

參數屬性

類型:PSObject
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzureRMContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Description

HostPool 的描述。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FriendlyName

HostPool 的易記名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InputObject

Identity 參數

參數屬性

類型:IDesktopVirtualizationIdentity
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateViaIdentityExpanded
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-JsonFilePath

提供給更新作業的 Json 檔案路徑

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-JsonString

提供給更新作業的 Json 字串

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-LoadBalancerType

負載平衡器的型別。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaxSessionLimit

HostPool 的最大會話限制。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定資源群組內主機集區的名稱

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:HostPoolName

參數集

UpdateExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PersonalDesktopAssignmentType

HostPool 的個人DesktopAssignment 類型。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PreferredAppGroupType

慣用應用程式群組類型的類型,預設為傳統型應用程式群組

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PublicNetworkAccess

已啟用以允許從公用網路存取此資源

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RegistrationInfoExpirationTime

註冊令牌的到期時間。

參數屬性

類型:DateTime
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RegistrationInfoRegistrationTokenOperation

重設令牌的類型。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

資源群組的名稱。 名稱不區分大小寫。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Ring

HostPool 的通道編號。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SsoadfsAuthority

客戶 ADFS 伺服器的 URL,用於簽署 WVD SSO 憑證。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SsoClientId

用來發出 WVD SSO 憑證之已註冊信賴憑證者的 ClientId。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SsoClientSecretKeyVaultPath

儲存用來與 ADFS 通訊之秘密的 Azure KeyVault 路徑。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SsoSecretType

密碼類型上的單一登錄類型。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StartVMOnConnect

要開啟/關閉 StartVMOnConnect 功能的旗標。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SubscriptionId

目標訂用帳戶的標識碼。 此值必須是 UUID。

參數屬性

類型:String
預設值:(Get-AzContext).Subscription.Id
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaJsonString
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaJsonFilePath
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Tag

標籤要更新

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ValidationEnvironment

這是驗證環境。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-VMTemplate

主機集區內會話主機設定的 VM 範本。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
UpdateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

IDesktopVirtualizationIdentity

輸出

IHostPool