Microsoft. DesktopVirtualization hostPools 2021-09-03-preview

Bicep-resursdefinition

Resurstypen hostPools kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Användningsexempel

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
Värdpool för Azure Virtual Desktop (AVD) AVM-resursmodul för Värdpool för Azure Virtual Desktop (AVD)

Azure-snabbstartsexempel

Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.

Bicep-fil Beskrivning
skapar AVD med Microsoft Entra ID Join Med den här mallen kan du skapa Azure Virtual Desktop-resurser som värdpool, programgrupp, arbetsyta, en testsessionsvärd och dess tillägg med Microsoft Entra ID-anslutning

Resursformat

Om du vill skapa en Microsoft.DesktopVirtualization/hostPools-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.DesktopVirtualization/hostPools@2021-09-03-preview' = {
  identity: {
    type: 'SystemAssigned'
  }
  kind: 'string'
  location: 'string'
  managedBy: 'string'
  name: 'string'
  plan: {
    name: 'string'
    product: 'string'
    promotionCode: 'string'
    publisher: 'string'
    version: 'string'
  }
  properties: {
    customRdpProperty: 'string'
    description: 'string'
    friendlyName: 'string'
    hostPoolType: 'string'
    loadBalancerType: 'string'
    maxSessionLimit: int
    migrationRequest: {
      migrationPath: 'string'
      operation: 'string'
    }
    personalDesktopAssignmentType: 'string'
    preferredAppGroupType: 'string'
    publicNetworkAccess: 'string'
    registrationInfo: {
      expirationTime: 'string'
      registrationTokenOperation: 'string'
      token: 'string'
    }
    ring: int
    ssoadfsAuthority: 'string'
    ssoClientId: 'string'
    ssoClientSecretKeyVaultPath: 'string'
    ssoSecretType: 'string'
    startVMOnConnect: bool
    validationEnvironment: bool
    vmTemplate: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Egenskapsvärden

Microsoft.DesktopVirtualization/hostPools

Namn Beskrivning Värde
identitet ResourceModelWithAllowedPropertySetIdentity
sort Metadata som används av portalen/verktyg/etc för att återge olika UX-funktioner för resurser av samma typ; Till exempel apiApps är en typ av Microsoft.Web/sites-typ. Om det stöds måste resursprovidern verifiera och bevara det här värdet. sträng

Begränsningar:
Mönster = ^[-\w\._,\(\)]+$
plats Den geo-plats där resursen finns sträng
hanterasAv Det fullständigt kvalificerade resurs-ID:t för resursen som hanterar den här resursen. Anger om den här resursen hanteras av en annan Azure-resurs. Om detta finns tar distributionen i fullständigt läge inte bort resursen om den tas bort från mallen eftersom den hanteras av en annan resurs. sträng
Namn Resursnamnet sträng

Begränsningar:
Min längd = 3
Maximal längd = 64 (krävs)
plan/planering/strategi ResourceModelWithAllowedPropertySetPlan
Egenskaper Detaljerade egenskaper för HostPool HostPoolProperties (krävs)
Sku ResourceModelWithAllowedPropertySetSku
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

HostPoolEgenskaper

Namn Beskrivning Värde
customRdpProperty Anpassad rdp-egenskap för HostPool. sträng
beskrivning Beskrivning av HostPool. sträng
användarvänligt namn Eget namn på HostPool. sträng
hostPoolType HostPool-typ för skrivbord. "BYODesktop"
"Personligt"
"Pooled" (krävs)
loadBalancerType Typen av lastbalanserare. "BreadthFirst"
"DepthFirst"
"Beständiga" (krävs)
maxSessionLimit Maximal sessionsgräns för HostPool. Int
migrationBegäran Registreringsinformationen för HostPool. MigrationRequestProperties (på engelska)
personalDesktopAssignmentType PersonalDesktopAssignment-typ för HostPool. "Automatisk"
"Direkt"
preferredAppGroupType Typ av önskad programgruppstyp, standard för skrivbordsprogramgrupp "Desktop"
"Ingen"
"RailApplications" (krävs)
publicNetworkAccess (publicNetworkÅtkomst) Aktiverad gör att den här resursen kan nås från både offentliga och privata nätverk. Inaktiverad tillåter att den här resursen endast nås via privata slutpunkter "Inaktiverad"
"Aktiverad"
registreringInfo Registreringsinformationen för HostPool. RegistrationInfo (på engelska)
ring Ringnumret för HostPool. Int
ssoadfsmyndighet URL till kundens ADFS-server för signering av WVD SSO-certifikat. sträng
ssoClientId ClientId för den registrerade förlitande parten som används för att utfärda WVD SSO-certifikat. sträng
ssoClientSecretKeyVaultPath Sökväg till Azure KeyVault som lagrar hemligheten som används för kommunikation till ADFS. sträng
ssoSecretType Typen av enkel inloggning på hemlig typ. "Certifikat"
"CertificateInKeyVault"
"SharedKey"
"SharedKeyInKeyVault"
startVMOnConnect Flaggan för att aktivera/inaktivera funktionen StartVMOnConnect. Bool
validationEnvironment (validering) Är valideringsmiljö. Bool
vm-mall VM-mall för konfiguration av sessionsvärdar i värdpoolen. sträng

MigrationRequestProperties (på engelska)

Namn Beskrivning Värde
migrationPath Sökvägen till det äldre objektet som ska migreras. sträng
Operation Typ av åtgärd för migrering. "Slutfört"
"Dölj"
"Återkalla"
"Start"
"Ta fram"

RegistrationInfo (på engelska)

Namn Beskrivning Värde
utgångstid Förfallotid för registreringstoken. sträng
registrationTokenOperation Typ av återställning av token. "Ta bort"
"Ingen"
"Uppdatera"
bevis Den base64-kodade strängen för registreringstoken. sträng

ResourceModelWithAllowedPropertySetIdentity

Namn Beskrivning Värde
typ Identitetstypen. "SystemAssigned"

ResourceModelWithAllowedPropertySetPlan

Namn Beskrivning Värde
Namn Ett användardefinierat namn på den artefakt från tredje part som införskaffas. sträng (krävs)
produkt Artefakten från tredje part som införskaffas. T.ex. NewRelic. Produkten mappar till OfferID som angetts för artefakten vid tidpunkten för registrering av datamarknaden. sträng (krävs)
kampanjkod En utgivare tillhandahöll kampanjkod som etablerats på datamarknaden för den nämnda produkten/artefakten. sträng
förläggare Utgivaren av den tredjepartsartefakt som köps. T.ex. NewRelic sträng (krävs)
version Versionen av önskad produkt/artefakt. sträng

ResourceModelWithAllowedPropertySetSku

Namn Beskrivning Värde
kapacitet Om SKU:n stöder utskalning/in bör kapacitets heltal inkluderas. Om det inte går att skala ut/in för resursen kan detta utelämnas. Int
familj Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. sträng
Namn Namnet på SKU:n. Ex - P3. Det är vanligtvis en bokstav+nummerkod sträng (krävs)
storlek SKU-storleken. När namnfältet är kombinationen av nivå och något annat värde är detta den fristående koden. sträng
Nivå Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT. "Grundläggande"
"Kostnadsfri"
"Premium"
"Standard"

ResourceModelWithAllowedPropertySetTags

Namn Beskrivning Värde

Resursdefinition för ARM-mall

Resurstypen hostPools kan distribueras med åtgärder som mål:

Användningsexempel

Azure-snabbstartsmallar

Följande Azure-snabbstartsmallar distribuera den här resurstypen.

Mall Beskrivning
skapar AVD med Microsoft Entra ID Join

Distribuera till Azure
Med den här mallen kan du skapa Azure Virtual Desktop-resurser som värdpool, programgrupp, arbetsyta, en testsessionsvärd och dess tillägg med Microsoft Entra ID-anslutning

Resursformat

Om du vill skapa en Microsoft.DesktopVirtualization/hostPools-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.DesktopVirtualization/hostPools",
  "apiVersion": "2021-09-03-preview",
  "name": "string",
  "identity": {
    "type": "SystemAssigned"
  },
  "kind": "string",
  "location": "string",
  "managedBy": "string",
  "plan": {
    "name": "string",
    "product": "string",
    "promotionCode": "string",
    "publisher": "string",
    "version": "string"
  },
  "properties": {
    "customRdpProperty": "string",
    "description": "string",
    "friendlyName": "string",
    "hostPoolType": "string",
    "loadBalancerType": "string",
    "maxSessionLimit": "int",
    "migrationRequest": {
      "migrationPath": "string",
      "operation": "string"
    },
    "personalDesktopAssignmentType": "string",
    "preferredAppGroupType": "string",
    "publicNetworkAccess": "string",
    "registrationInfo": {
      "expirationTime": "string",
      "registrationTokenOperation": "string",
      "token": "string"
    },
    "ring": "int",
    "ssoadfsAuthority": "string",
    "ssoClientId": "string",
    "ssoClientSecretKeyVaultPath": "string",
    "ssoSecretType": "string",
    "startVMOnConnect": "bool",
    "validationEnvironment": "bool",
    "vmTemplate": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Egenskapsvärden

Microsoft.DesktopVirtualization/hostPools

Namn Beskrivning Värde
apiVersion API-versionen "2021-09-03-preview"
identitet ResourceModelWithAllowedPropertySetIdentity
sort Metadata som används av portalen/verktyg/etc för att återge olika UX-funktioner för resurser av samma typ; Till exempel apiApps är en typ av Microsoft.Web/sites-typ. Om det stöds måste resursprovidern verifiera och bevara det här värdet. sträng

Begränsningar:
Mönster = ^[-\w\._,\(\)]+$
plats Den geo-plats där resursen finns sträng
hanterasAv Det fullständigt kvalificerade resurs-ID:t för resursen som hanterar den här resursen. Anger om den här resursen hanteras av en annan Azure-resurs. Om detta finns tar distributionen i fullständigt läge inte bort resursen om den tas bort från mallen eftersom den hanteras av en annan resurs. sträng
Namn Resursnamnet sträng

Begränsningar:
Min längd = 3
Maximal längd = 64 (krävs)
plan/planering/strategi ResourceModelWithAllowedPropertySetPlan
Egenskaper Detaljerade egenskaper för HostPool HostPoolProperties (krävs)
Sku ResourceModelWithAllowedPropertySetSku
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.DesktopVirtualization/hostPools"

HostPoolEgenskaper

Namn Beskrivning Värde
customRdpProperty Anpassad rdp-egenskap för HostPool. sträng
beskrivning Beskrivning av HostPool. sträng
användarvänligt namn Eget namn på HostPool. sträng
hostPoolType HostPool-typ för skrivbord. "BYODesktop"
"Personligt"
"Pooled" (krävs)
loadBalancerType Typen av lastbalanserare. "BreadthFirst"
"DepthFirst"
"Beständiga" (krävs)
maxSessionLimit Maximal sessionsgräns för HostPool. Int
migrationBegäran Registreringsinformationen för HostPool. MigrationRequestProperties (på engelska)
personalDesktopAssignmentType PersonalDesktopAssignment-typ för HostPool. "Automatisk"
"Direkt"
preferredAppGroupType Typ av önskad programgruppstyp, standard för skrivbordsprogramgrupp "Desktop"
"Ingen"
"RailApplications" (krävs)
publicNetworkAccess (publicNetworkÅtkomst) Aktiverad gör att den här resursen kan nås från både offentliga och privata nätverk. Inaktiverad tillåter att den här resursen endast nås via privata slutpunkter "Inaktiverad"
"Aktiverad"
registreringInfo Registreringsinformationen för HostPool. RegistrationInfo (på engelska)
ring Ringnumret för HostPool. Int
ssoadfsmyndighet URL till kundens ADFS-server för signering av WVD SSO-certifikat. sträng
ssoClientId ClientId för den registrerade förlitande parten som används för att utfärda WVD SSO-certifikat. sträng
ssoClientSecretKeyVaultPath Sökväg till Azure KeyVault som lagrar hemligheten som används för kommunikation till ADFS. sträng
ssoSecretType Typen av enkel inloggning på hemlig typ. "Certifikat"
"CertificateInKeyVault"
"SharedKey"
"SharedKeyInKeyVault"
startVMOnConnect Flaggan för att aktivera/inaktivera funktionen StartVMOnConnect. Bool
validationEnvironment (validering) Är valideringsmiljö. Bool
vm-mall VM-mall för konfiguration av sessionsvärdar i värdpoolen. sträng

MigrationRequestProperties (på engelska)

Namn Beskrivning Värde
migrationPath Sökvägen till det äldre objektet som ska migreras. sträng
Operation Typ av åtgärd för migrering. "Slutfört"
"Dölj"
"Återkalla"
"Start"
"Ta fram"

RegistrationInfo (på engelska)

Namn Beskrivning Värde
utgångstid Förfallotid för registreringstoken. sträng
registrationTokenOperation Typ av återställning av token. "Ta bort"
"Ingen"
"Uppdatera"
bevis Den base64-kodade strängen för registreringstoken. sträng

ResourceModelWithAllowedPropertySetIdentity

Namn Beskrivning Värde
typ Identitetstypen. "SystemAssigned"

ResourceModelWithAllowedPropertySetPlan

Namn Beskrivning Värde
Namn Ett användardefinierat namn på den artefakt från tredje part som införskaffas. sträng (krävs)
produkt Artefakten från tredje part som införskaffas. T.ex. NewRelic. Produkten mappar till OfferID som angetts för artefakten vid tidpunkten för registrering av datamarknaden. sträng (krävs)
kampanjkod En utgivare tillhandahöll kampanjkod som etablerats på datamarknaden för den nämnda produkten/artefakten. sträng
förläggare Utgivaren av den tredjepartsartefakt som köps. T.ex. NewRelic sträng (krävs)
version Versionen av önskad produkt/artefakt. sträng

ResourceModelWithAllowedPropertySetSku

Namn Beskrivning Värde
kapacitet Om SKU:n stöder utskalning/in bör kapacitets heltal inkluderas. Om det inte går att skala ut/in för resursen kan detta utelämnas. Int
familj Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. sträng
Namn Namnet på SKU:n. Ex - P3. Det är vanligtvis en bokstav+nummerkod sträng (krävs)
storlek SKU-storleken. När namnfältet är kombinationen av nivå och något annat värde är detta den fristående koden. sträng
Nivå Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT. "Grundläggande"
"Kostnadsfri"
"Premium"
"Standard"

ResourceModelWithAllowedPropertySetTags

Namn Beskrivning Värde

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen hostPools kan distribueras med åtgärder som mål:

  • Resursgrupper För en lista över ändrade egenskaper i varje API-version, se ändringslogg.

Användningsexempel

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
Värdpool för Azure Virtual Desktop (AVD) AVM-resursmodul för Värdpool för Azure Virtual Desktop (AVD)

Resursformat

Om du vill skapa en Microsoft.DesktopVirtualization/hostPools-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DesktopVirtualization/hostPools@2021-09-03-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    managedBy = "string"
    plan = {
      name = "string"
      product = "string"
      promotionCode = "string"
      publisher = "string"
      version = "string"
    }
    properties = {
      customRdpProperty = "string"
      description = "string"
      friendlyName = "string"
      hostPoolType = "string"
      loadBalancerType = "string"
      maxSessionLimit = int
      migrationRequest = {
        migrationPath = "string"
        operation = "string"
      }
      personalDesktopAssignmentType = "string"
      preferredAppGroupType = "string"
      publicNetworkAccess = "string"
      registrationInfo = {
        expirationTime = "string"
        registrationTokenOperation = "string"
        token = "string"
      }
      ring = int
      ssoadfsAuthority = "string"
      ssoClientId = "string"
      ssoClientSecretKeyVaultPath = "string"
      ssoSecretType = "string"
      startVMOnConnect = bool
      validationEnvironment = bool
      vmTemplate = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Egenskapsvärden

Microsoft.DesktopVirtualization/hostPools

Namn Beskrivning Värde
identitet ResourceModelWithAllowedPropertySetIdentity
sort Metadata som används av portalen/verktyg/etc för att återge olika UX-funktioner för resurser av samma typ; Till exempel apiApps är en typ av Microsoft.Web/sites-typ. Om det stöds måste resursprovidern verifiera och bevara det här värdet. sträng

Begränsningar:
Mönster = ^[-\w\._,\(\)]+$
plats Den geo-plats där resursen finns sträng
hanterasAv Det fullständigt kvalificerade resurs-ID:t för resursen som hanterar den här resursen. Anger om den här resursen hanteras av en annan Azure-resurs. Om detta finns tar distributionen i fullständigt läge inte bort resursen om den tas bort från mallen eftersom den hanteras av en annan resurs. sträng
Namn Resursnamnet sträng

Begränsningar:
Min längd = 3
Maximal längd = 64 (krävs)
plan/planering/strategi ResourceModelWithAllowedPropertySetPlan
Egenskaper Detaljerade egenskaper för HostPool HostPoolProperties (krävs)
Sku ResourceModelWithAllowedPropertySetSku
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.DesktopVirtualization/hostPools@2021-09-03-preview"

HostPoolEgenskaper

Namn Beskrivning Värde
customRdpProperty Anpassad rdp-egenskap för HostPool. sträng
beskrivning Beskrivning av HostPool. sträng
användarvänligt namn Eget namn på HostPool. sträng
hostPoolType HostPool-typ för skrivbord. "BYODesktop"
"Personligt"
"Pooled" (krävs)
loadBalancerType Typen av lastbalanserare. "BreadthFirst"
"DepthFirst"
"Beständiga" (krävs)
maxSessionLimit Maximal sessionsgräns för HostPool. Int
migrationBegäran Registreringsinformationen för HostPool. MigrationRequestProperties (på engelska)
personalDesktopAssignmentType PersonalDesktopAssignment-typ för HostPool. "Automatisk"
"Direkt"
preferredAppGroupType Typ av önskad programgruppstyp, standard för skrivbordsprogramgrupp "Desktop"
"Ingen"
"RailApplications" (krävs)
publicNetworkAccess (publicNetworkÅtkomst) Aktiverad gör att den här resursen kan nås från både offentliga och privata nätverk. Inaktiverad tillåter att den här resursen endast nås via privata slutpunkter "Inaktiverad"
"Aktiverad"
registreringInfo Registreringsinformationen för HostPool. RegistrationInfo (på engelska)
ring Ringnumret för HostPool. Int
ssoadfsmyndighet URL till kundens ADFS-server för signering av WVD SSO-certifikat. sträng
ssoClientId ClientId för den registrerade förlitande parten som används för att utfärda WVD SSO-certifikat. sträng
ssoClientSecretKeyVaultPath Sökväg till Azure KeyVault som lagrar hemligheten som används för kommunikation till ADFS. sträng
ssoSecretType Typen av enkel inloggning på hemlig typ. "Certifikat"
"CertificateInKeyVault"
"SharedKey"
"SharedKeyInKeyVault"
startVMOnConnect Flaggan för att aktivera/inaktivera funktionen StartVMOnConnect. Bool
validationEnvironment (validering) Är valideringsmiljö. Bool
vm-mall VM-mall för konfiguration av sessionsvärdar i värdpoolen. sträng

MigrationRequestProperties (på engelska)

Namn Beskrivning Värde
migrationPath Sökvägen till det äldre objektet som ska migreras. sträng
Operation Typ av åtgärd för migrering. "Slutfört"
"Dölj"
"Återkalla"
"Start"
"Ta fram"

RegistrationInfo (på engelska)

Namn Beskrivning Värde
utgångstid Förfallotid för registreringstoken. sträng
registrationTokenOperation Typ av återställning av token. "Ta bort"
"Ingen"
"Uppdatera"
bevis Den base64-kodade strängen för registreringstoken. sträng

ResourceModelWithAllowedPropertySetIdentity

Namn Beskrivning Värde
typ Identitetstypen. "SystemAssigned"

ResourceModelWithAllowedPropertySetPlan

Namn Beskrivning Värde
Namn Ett användardefinierat namn på den artefakt från tredje part som införskaffas. sträng (krävs)
produkt Artefakten från tredje part som införskaffas. T.ex. NewRelic. Produkten mappar till OfferID som angetts för artefakten vid tidpunkten för registrering av datamarknaden. sträng (krävs)
kampanjkod En utgivare tillhandahöll kampanjkod som etablerats på datamarknaden för den nämnda produkten/artefakten. sträng
förläggare Utgivaren av den tredjepartsartefakt som köps. T.ex. NewRelic sträng (krävs)
version Versionen av önskad produkt/artefakt. sträng

ResourceModelWithAllowedPropertySetSku

Namn Beskrivning Värde
kapacitet Om SKU:n stöder utskalning/in bör kapacitets heltal inkluderas. Om det inte går att skala ut/in för resursen kan detta utelämnas. Int
familj Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. sträng
Namn Namnet på SKU:n. Ex - P3. Det är vanligtvis en bokstav+nummerkod sträng (krävs)
storlek SKU-storleken. När namnfältet är kombinationen av nivå och något annat värde är detta den fristående koden. sträng
Nivå Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT. "Grundläggande"
"Kostnadsfri"
"Premium"
"Standard"

ResourceModelWithAllowedPropertySetTags

Namn Beskrivning Värde