> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/user/general/assign-windows365.md).

# Windows365 zuweisen

Für diesen Benutzer einen Windows 365 Cloud PC bereitstellen

### Beschreibung

Weist diesem Benutzer die Gruppen zu, die die Windows 365-Bereitstellung auslösen: die Bereitstellungsrichtlinie oder Frontline-Zuweisung, die Benutzereinstellungen-Richtlinie und, für einen dedizierten Cloud PC, die Lizenzgruppe. Optional erhält der Benutzer eine E-Mail, sobald der Cloud PC bereit ist, und per E-Mail wird ein Service-Ticket erstellt, wenn keine Lizenzen oder Frontline-Plätze mehr übrig sind.

### Bietet die Richtlinien- und Lizenzgruppen als Dropdowns an

Die Bereitstellungsrichtlinie, die Benutzereinstellungen-Richtlinie und die Lizenzgruppe sind standardmäßig reine Textfelder. Wandeln Sie sie über die Runbook-Anpassung in Dropdowns mit den Gruppennamen Ihres Tenants um:

```json
"rjgit-user_general_assign-windows365": {
    "Parameters": {
        "cfgProvisioningGroupName": {
            "SelectSimple": {
                "cfg - Windows 365 - Provisioning - Win11": "cfg - Windows 365 - Provisioning - Win11",
                "cfg - Windows 365 - Provisioning - Win10": "cfg - Windows 365 - Provisioning - Win10"
            }
        },
        "cfgUserSettingsGroupName": {
            "SelectSimple": {
                "cfg - Windows 365 - User Settings - restore allowed": "cfg - Windows 365 - User Settings - restore allowed",
                "cfg - Windows 365 - User Settings - no restore": "cfg - Windows 365 - User Settings - no restore"
            }
        },
        "licWin365GroupName": {
            "SelectSimple": {
                "lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB": "lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB",
                "lic - Windows 365 Enterprise - 2 vCPU 4 GB 256 GB": "lic - Windows 365 Enterprise - 2 vCPU 4 GB 256 GB"
            }
        }
    }
}
```

Die Gruppennamen-Präfixe (`cfgProvisioningGroupPrefix`, `cfgUserSettingsGroupPrefix`) legen fest, welche Gruppen als Bereitstellungs- oder Benutzereinstellungen-Gruppen zählen; passen Sie sie am gleichen Ort an, wenn Ihre Benennung abweicht.

Weitere Informationen zur Anpassung von Runbooks finden Sie im [Runbook-Anpassungsleitfaden](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Speicherort

Benutzer → Allgemein → Windows365 zuweisen

**Voller Runbook-Name**

rjgit-user\_general\_assign-windows365

### Details

| Eigenschaft          | Wert                                |
| -------------------- | ----------------------------------- |
| Version              | 1.0.1                               |
| Erforderliche Module | RealmJoin.RunbookHelper (>= 0.8.10) |
| Planbar              | nein                                |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * User.Read.All
    * *Ermittelt den Zielbenutzer über die UPN und prüft vor dem Versenden, ob ein Postfach vorhanden ist*
  * GroupMember.ReadWrite.All
    * *Fügt den Benutzer den Bereitstellungs-, Benutzereinstellungen- und Lizenzgruppen hinzu*
  * Group.ReadWrite.All
    * *Sucht die Konfigurations- und Lizenzgruppen und liest die ihnen zugewiesenen Lizenzen aus*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet das Ticket wegen fehlender Lizenzen und die Benachrichtigung an den Benutzer, wenn die E-Mail-Optionen aktiviert sind*
  * CloudPC.Read.All
    * *Liest die Bereitstellungsrichtlinien, Servicepläne für die gemeinsame Nutzung und die Cloud PCs des Benutzers aus*
  * Organization.Read.All
    * *Liest /subscribedSkus aus, um im Pfad für den dedizierten Plan eine freie Windows 365-Lizenz zu prüfen*

### Parameter

#### Benutzername

Benutzerprinzipalname des Benutzers, auf den das Runbook angewendet wird. Wird vom Portal aus dem ausgewählten Benutzer gesetzt.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | wahr                                            |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### cfgProvisioningGroupName

Gruppenname der Bereitstellungsrichtlinie für einen dedizierten Cloud PC oder der Name der Frontline-Bereitstellungsrichtlinie. Geben Sie den Namen ein oder wählen Sie ihn aus, wenn Ihre Runbook-Anpassung eine Liste anbietet.

| Eigenschaft           | Wert                                               |
| --------------------- | -------------------------------------------------- |
| Erforderlich          | falsch                                             |
| Standardwert          | cfg - Windows 365 - Provisioning - Win11           |
| Typ                   | Zeichenfolge                                       |
| Anzeigename im Portal | Bereitstellungsrichtlinie oder Frontline-Zuweisung |

#### cfgUserSettingsGroupName

Gruppe, die die Benutzereinstellungen-Richtlinie enthält, z. B. ob der Benutzer den Cloud PC wiederherstellen darf.

| Eigenschaft           | Wert                                                |
| --------------------- | --------------------------------------------------- |
| Erforderlich          | falsch                                              |
| Standardwert          | cfg - Windows 365 - User Settings - restore allowed |
| Typ                   | Zeichenfolge                                        |
| Anzeigename im Portal | Benutzereinstellungen-Richtlinie                    |

#### licWin365GroupName

Lizenzgruppe für einen dedizierten Cloud PC. Für Frontline nicht erforderlich.

| Eigenschaft           | Wert                                              |
| --------------------- | ------------------------------------------------- |
| Erforderlich          | falsch                                            |
| Standardwert          | lic - Windows 365 Enterprise - 2 vCPU 4 GB 128 GB |
| Typ                   | Zeichenfolge                                      |
| Anzeigename im Portal | Windows 365-Lizenz (dedizierter Cloud PC)         |

#### cfgProvisioningGroupPrefix

Namenspräfix, das Bereitstellungsrichtlinien-Gruppen identifiziert. In der Runbook-Anpassung voreingestellt.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | cfg - Windows 365 - Provisioning -              |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### cfgUserSettingsGroupPrefix

Namenspräfix, das Benutzereinstellungen-Richtlinien-Gruppen identifiziert. In der Runbook-Anpassung voreingestellt.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | cfg - Windows 365 - User Settings -             |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### sendMailWhenProvisioned

Sendet dem Benutzer eine E-Mail, sobald die Bereitstellung abgeschlossen ist.

| Eigenschaft           | Wert                                                        |
| --------------------- | ----------------------------------------------------------- |
| Erforderlich          | falsch                                                      |
| Standardwert          | Falsch                                                      |
| Typ                   | Boolesch                                                    |
| Anzeigename im Portal | Den Benutzer benachrichtigen, wenn der Cloud PC bereit ist? |

#### customizeMail

Ersetzt den standardmäßigen Benachrichtigungstext durch Ihre eigene Nachricht. Wird nur verwendet, wenn der Benutzer benachrichtigt wird.

| Eigenschaft           | Wert                                   |
| --------------------- | -------------------------------------- |
| Erforderlich          | falsch                                 |
| Standardwert          | Falsch                                 |
| Typ                   | Boolesch                               |
| Anzeigename im Portal | Die Benachrichtigungs-E-Mail anpassen? |

**Portaloptionen**

| Portaloption                                | Wert   |
| ------------------------------------------- | ------ |
| Standard-E-Mail verwenden                   | falsch |
| Eine benutzerdefinierte Nachricht verwenden | wahr   |

#### customMailMessage

Text der Benachrichtigungs-E-Mail.

| Eigenschaft           | Wert                                                                    |
| --------------------- | ----------------------------------------------------------------------- |
| Erforderlich          | falsch                                                                  |
| Standardwert          | Benutzerdefinierte Nachricht hier einfügen. (Begrenzt auf 3000 Zeichen) |
| Typ                   | Zeichenfolge                                                            |
| Anzeigename im Portal | Benutzerdefinierte Nachricht                                            |

#### createTicketOutOfLicenses

Sendet eine Ticket-E-Mail an den Service Desk, wenn keine Lizenz oder kein Frontline-Platz verfügbar ist.

| Eigenschaft           | Wert                                                            |
| --------------------- | --------------------------------------------------------------- |
| Erforderlich          | falsch                                                          |
| Standardwert          | Falsch                                                          |
| Typ                   | Boolesch                                                        |
| Anzeigename im Portal | Ein Service-Ticket öffnen, wenn die Lizenzen aufgebraucht sind? |

#### ticketQueueAddress

Postfach des Service Desks, das die E-Mail in ein Ticket umwandelt.

| Eigenschaft           | Wert                          |
| --------------------- | ----------------------------- |
| Erforderlich          | falsch                        |
| Standardwert          | <support@glueckkanja-gab.com> |
| Typ                   | Zeichenfolge                  |
| Anzeigename im Portal | Adresse für Service-Tickets   |

#### fromMailAddress

Postfach, von dem die Benachrichtigungs- und Ticket-E-Mails gesendet werden.

| Eigenschaft           | Wert                   |
| --------------------- | ---------------------- |
| Erforderlich          | falsch                 |
| Standardwert          | <runbooks@contoso.com> |
| Typ                   | Zeichenfolge           |
| Anzeigename im Portal | Absenderpostfach       |

#### ticketCustomerId

Kundenkennung, die in den Betreff des Tickets eingefügt wird.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | falsch                |
| Standardwert          | Contoso               |
| Typ                   | Zeichenfolge          |
| Anzeigename im Portal | Kunden-ID für Tickets |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/user/general/assign-windows365.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.