Uppdatera sessionsvärdar med sessionsvärduppdatering i Azure Virtual Desktop (förhandsversion)

Så här schemalägger du en ny uppdatering för sessionsvärdarna med hjälp av Azure Portal.

1. Logga in på Azure-portalen.

2. I sökfältet anger du Azure Virtual Desktop och väljer matchande tjänstpost.

3. Välj Värdpooler och välj sedan värdpoolen med en sessionsvärdkonfiguration som du vill uppdatera.

4. Välj Sessionsvärdar.

5. Om du vill granska sessionsvärdkonfigurationen innan du schemalägger en uppdatering väljer du Hantera sessionsvärdkonfiguration och sedan Visa. När du har granskat sessionsvärdkonfigurationen väljer du Avbryt.

6. Om du vill schemalägga en ny uppdatering väljer du Hantera uppdatering av sessionsvärd och sedan Ny uppdatering. Du kan också välja Hantera sessionsvärdkonfiguration och sedan Redigera.

7. På fliken Grundläggande fyller du i följande information:

   Parameter	Värde/beskrivning
   Aktuell storlek på värdpoolen (skrivskyddad)	Antalet sessionsvärdar i värdpoolen.
   Den virtuella datorns batchstorlek har behörighet att tas bort från värdpoolen under uppdateringen	Det maximala antalet sessionsvärdar som uppdateras åt gången. När uppdateringen startar uppdateras endast en sessionsvärd, som kallas den första, först för att verifiera uppdateringsprocessen innan de återstående sessionsvärdarna uppdateras i batchar. Om uppdateringen av den första inte lyckas stoppas uppdateringen.
   Sessionsvärdar som är tillgängliga under uppdateringen (skrivskyddade)	Det minsta antalet sessionsvärdar som är tillgängliga för användarsessioner under uppdateringen.

   När du har slutfört den här fliken väljer du Nästa: Sessionsvärdar.

8. På fliken Sessionsvärdar kan du uppdatera följande parametrar i sessionsvärdkonfigurationen:

   Parameter	Värde/beskrivning
   Säkerhetstyp	Välj från Standard, Betrodda starta virtuella datorer eller Konfidentiella virtuella datorer. – Om du väljer Betrodda virtuella startdatorer väljs alternativ för säker start och vTPM automatiskt. – Om du väljer Konfidentiella virtuella datorer väljs automatiskt alternativ för säker start, vTPM och integritetsövervakning . Du kan inte avanmäla dig från vTPM när du använder en konfidentiell virtuell dator.
   Bild	Välj den OS-avbildning som du vill använda i listan eller välj Visa alla bilder om du vill se fler, inklusive anpassade avbildningar som du har skapat och lagrat som en delad avbildning i Azure Compute Gallery eller en hanterad avbildning.
   Storlek på virtuell dator	Välj en rekommenderad SKU i listan. Om du vill använda en annan SKU väljer du Visa alla storlekar och väljer sedan i listan.
   Os-disktyp	Välj den disktyp som ska användas för sessionsvärdarna. Vi rekommenderar att du använder Premium SSD för produktionsarbetsbelastningar. Disktypen måste stödjas för den virtuella datorfamiljen och storleken som valts. Se till att du väljer en kombination som Stöds av Azure Compute. Namnet på OS-disken för de uppdaterade sessionsvärdarna har ett nytt namn i formatet SessionHostName-DateTime_Hash.
   Domän som ska anslutas
   Välj vilken katalog du vill ansluta till	Välj antingen Microsoft Entra eller Active Directory. Om du använder Active Directory väljer du det nyckelvalv som innehåller hemligheterna för användarnamnet och lösenordet för domänanslutningskontot. Du kan också ange ett domännamn och en organisationsenhetssökväg.
   Administratörskonto för virtuell dator	Slutför relevanta parametrar genom att välja nyckelvalvet och hemligheten för användarnamnet och lösenordet för det lokala administratörskontot för de uppdaterade virtuella sessionsvärddatorerna. Användarnamnet och lösenordet måste uppfylla kraven för virtuella Windows-datorer i Azure.
   Anpassad konfiguration
   URL för anpassat konfigurationsskript	Om du vill köra ett PowerShell-skript under distributionen kan du ange URL:en här.

   När du har granskat eller slutfört ändringarna i sessionsvärdkonfigurationen väljer du Nästa: Schemalägg.

9. På fliken Schema markerar du antingen kryssrutan Schemalägg uppdatering nu eller väljer ett datum, tid och en tidszon som du vill att uppdateringen ska starta, upp till högst två veckor från den aktuella tiden.

   När du har angett schemat väljer du Nästa: Meddelanden.

10. På fliken Meddelanden fyller du i följande information:

    Parameter	Värde/beskrivning
    Minuter innan användarna loggas ut	Hur lång tid det ska ta att vänta efter uppdateringens starttid för att användarna ska meddelas att logga ut. Det här värdet kan konfigureras mellan 0 och 60 minuter. Användarna loggas automatiskt ut efter den här tiden.
    Utloggningsmeddelande	Ett meddelande som du kan ange för att informera användarna om att sessionsvärden de använder håller på att börja uppdateras.

    När du har slutfört den här fliken väljer du Nästa: Granska.

11. På fliken Granska kontrollerar du att verifieringen godkänns och granskar den information som används under uppdateringen.

12. Välj Uppdatera för att schemalägga uppdateringen. När du visar listan över sessionsvärdar visar kolumnen Aktuell version tidsstämpeln för den version av sessionsvärdkonfigurationen som sessionsvärden använder. Om kolumnen Aktuell version har en varningsikon innebär det att tidsstämpeln för versionen i kolumnen Målversion är senare och sessionsvärden måste uppdateras.

Så här schemalägger du en ny uppdatering för dina sessionsvärdar med hjälp av PowerShell-modulen Az.DesktopVirtualization . När du schemalägger en uppdatering används sessionsvärdkonfigurationen för värdpoolen. Du måste göra ändringar i sessionsvärdkonfigurationen innan du schemalägger en uppdatering.

Du kan uppdatera sessionsvärdhanteringsprincipen innan du schemalägger en uppdatering, där ändringarna sparas för framtida användning. Du kan också åsidosätta värdena i sessionsvärdhanteringsprincipen när du schemalägger en uppdatering, men de gäller bara för den uppdateringen.

1. Öppna Azure Cloud Shell i Azure Portal med PowerShell-terminaltypen eller kör PowerShell på din lokala enhet.

   • Om du använder Cloud Shell kontrollerar du att Azure-kontexten är inställd på den prenumeration som du vill använda.

   • Om du använder PowerShell lokalt loggar du först in med Azure PowerShell och kontrollerar sedan att Azure-kontexten är inställd på den prenumeration som du vill använda.

2. Använd cmdleten Update-AzWvdSessionHostConfiguration för att uppdatera sessionsvärdkonfigurationen, där du bara behöver ange de parametrar som du vill ändra. Här följer några exempelkommandon:

   • Om du vill ange en annan anpassad avbildning som sessionsvärdarna ska använda kör du följande kommando. Information om hur du hittar värdena för Marketplace-avbildningen finns i Hitta och använda virtuella Azure Marketplace-avbildningar med Azure PowerShell.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ImageInfoType = 'Custom'
          CustomInfoResourceID  = '/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Compute/galleries/<GalleryName>/images/<ImageName>/versions/<ImageVersion>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Om du vill ändra nyckelvalvet och hemligheten som lagrar lösenordet för det lokala administratörskontot kör du följande kommando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMAdminCredentialsUsernameKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
          VMAdminCredentialsPasswordKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Om du vill ändra storleken på den virtuella datorn till D8s_v5 och OS-disktypen till Premium SSD kör du följande kommando. Namnet på OS-disken för de uppdaterade sessionsvärdarna har ett nytt namn i formatet SessionHostName-DateTime_Hash.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMSizeId = 'Standard_D8s_v5'
          DiskInfoType = 'Premium_LRS'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   Visa sessionsvärdkonfigurationen för att verifiera ändringarna genom att köra följande kommando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostConfiguration @parameters | FL *
   

3. Valfritt: Om du vill uppdatera sessionsvärdhanteringsprincipen innan du schemalägger en uppdatering kör du följande kommando med hjälp av cmdleten Update-AzWvdSessionHostManagement . Du kan också åsidosätta specifika värden när du schemalägger en uppdatering, som endast används för den uppdateringen. Giltiga tidszonsvärden finns i Get-TimeZone PowerShell-referens och använd värdet från StandardName egenskapen . Vi rekommenderar att du ställer in UpdateDeleteOriginalVM = $true så att du inte behöver rensa sessionsvärdresurser efter en uppdatering.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       ScheduledDateTimeZone = '<TimeZoneID>'
       UpdateDeleteOriginalVM = <$true or $false>
       UpdateMaxVmsRemoved = '<Quantity>'
       UpdateLogOffDelayMinute = '<Minutes>'
       UpdateLogOffMessage = '<Message>'
   }
   
   Update-AzWvdSessionHostManagement @parameters
   

   Du kan visa egenskaperna för den uppdaterade sessionsvärdhanteringsprincipen genom att köra följande kommando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagement @parameters
   

4. Om du vill schemalägga en uppdatering använder du cmdleten Invoke-AzWvdInitiateSessionHostUpdate med följande exempel. Du kan schemalägga en uppdatering så att den startar omedelbart eller ange en tid som du vill att uppdateringen ska starta, upp till högst två veckor. Här följer några exempelkommandon:

   • Om du vill schemalägga en uppdatering så att den startar omedelbart och använder värdena från sessionsvärdhanteringsprincipen kör du följande kommando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Om du vill schemalägga en uppdatering vid en angiven tidpunkt och ett angivet datum (i formatet ÅÅÅÅ-MM-DD HH:mm) och använda värdena från sessionsvärdhanteringsprincipen kör du följande kommando.

     $dateTime = Get-Date -Date "2024-03-15 01:30"
     
     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ScheduledDateTime = $dateTime
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Starta en uppdatering som är schemalagd genom att köra följande kommando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = Start
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

5. Du kan visa egenskaperna för den schemalagda uppdateringen genom att köra följande kommando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
   

Så här övervakar du förloppet för en uppdatering med hjälp av Azure Portal.

1. I översikten över Azure Virtual Desktop väljer du Värdpooler och sedan den värdpool som du har schemalagt en uppdatering för.

2. Välj Sessionsvärdar.

3. En blå banderoll ger status för uppdateringen. Den visar bara en tidpunkt, så du måste välja Uppdatera för att kontrollera den senaste förloppet.

Om du har valt att starta uppdateringen omedelbart anger meddelandet att uppdateringen är schemalagd medan den börjar, men det här meddelandet uppdateras när du uppdaterar. Under en uppdatering ser du batchstorleksantalet sessionsvärdar som tas bort från värdpoolen under uppdateringen.

Så här övervakar du förloppet för en uppdatering med hjälp av PowerShell-modulen Az.DesktopVirtualization .

Från din befintliga PowerShell-session använder du cmdleten Get-AzWvdSessionHostManagementsUpdateStatus med följande exempel för att få information om den aktuella uppdateringen.

• Om du vill se förloppet för den senaste uppdateringen kör du följande kommandon:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
       FL PercentComplete,
       ProgressExecutionStartTime,
       ProgressSessionHostsCompleted,
       ProgressSessionHostsInProgress,
       ProgressSessionHostsRollbackFailed,
       ProgressTotalSessionHost,
       EndTime
  
  $updateProgress
  

• Om du vill se alla parametrar för den senaste uppdateringen kör du följande kommando:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
  
  $updateProgress
  

Så här pausar, återupptar, avbryter eller försöker du uppdatera igen med hjälp av Azure Portal.

1. I översikten över Azure Virtual Desktop väljer du Värdpooler och sedan den värdpool som du har schemalagt en uppdatering för.

2. Välj Sessionsvärdar och välj sedan Hantera uppdatering av sessionsvärd.

3. Välj Pausa, Återuppta, Avbryt eller Försök igen beroende på uppdateringens aktuella tillstånd.

4. Välj Uppdatera för att uppdatera statusmeddelandet i den blå banderollen. Det kan ta cirka 20 sekunder att visa rätt status.

Så här pausar, återupptar, avbryter eller försöker du uppdatera igen med hjälp av PowerShell-modulen Az.DesktopVirtualization .

Från din befintliga PowerShell-session använder du cmdleten Invoke-AzWvdControlSessionHostUpdate med följande exempel för att pausa eller återuppta den aktuella uppdateringen.

1. Kontrollera först uppdateringsstatusen genom att köra följande kommando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status
   

2. Använd något av följande exempel beroende på vilken åtgärd du vill vidta.

   • Om du vill pausa en uppdatering kör du följande kommando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Pause'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Kör följande kommando för att återuppta uppdateringen:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Resume'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Om du vill avbryta en uppdatering och inkludera ett meddelande kör du följande kommando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Cancel'
          CancelMessage = '<Message>'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Kör följande kommando för att försöka uppdatera igen:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Retry'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

3. Kontrollera uppdateringsåtgärden och statusen när du har utfört en åtgärd genom att köra följande kommando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status