> 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 Benutzerinstellungsrichtlinie und, für einen dedizierten Cloud PC, die Lizenzgruppe. Optional erhält der Benutzer eine E-Mail, sobald der Cloud PC bereit ist, und es wird per E-Mail ein Service-Ticket eröffnet, wenn keine Lizenzen oder Frontline-Plätze mehr verfügbar sind.

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

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

```json
"rjgit-user_general_assign-windows365": {
    "Parameter": {
        "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 Präfixe der Gruppennamen (`cfgProvisioningGroupPrefix`, `cfgUserSettingsGroupPrefix`) legen fest, welche Gruppen als Bereitstellungs- oder Benutzerinstellungsgruppen zählen; passen Sie sie an derselben Stelle an, wenn Ihre Benennung abweicht.

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

### Ort

Benutzer → Allgemein → Windows 365 zuweisen

**Vollständiger 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 anhand der UPN und prüft vor dem Versand, ob ein Postfach vorhanden ist*
  * GroupMember.ReadWrite.All
    * *Fügt den Benutzer den Bereitstellungs-, Benutzerinstellungs- und Lizenzgruppen hinzu*
  * Group.ReadWrite.All
    * *Sucht nach Konfigurations- und Lizenzgruppen und liest die ihnen zugewiesenen Lizenzen aus*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet das Ticket bei fehlenden Lizenzen und die Benachrichtigung an den Benutzer, wenn die E-Mail-Optionen aktiviert sind*
  * CloudPC.Read.All
    * *Liest die Bereitstellungsrichtlinien, gemeinsam genutzte Servicepläne und die Cloud PCs des Benutzers*
  * Organization.Read.All
    * *Liest /subscribedSkus, um im Pfad für den dedizierten Plan eine freie Windows 365-Lizenz zu prüfen*

### Parameter

#### Benutzername

Der Benutzerprinzipalname des Benutzers, für den das Runbook ausgeführt wird. Vom Portal anhand des ausgewählten Benutzers festgelegt.

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

#### cfgProvisioningGroupName

Bereitstellungsrichtliniengruppe 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 Benutzerinstellungsrichtlinie trägt, 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 | Benutzerinstellungsrichtlinie                       |

#### 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 Gruppen der Bereitstellungsrichtlinie identifiziert. In der Runbook-Anpassung voreingestellt.

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

#### cfgUserSettingsGroupPrefix

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

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | cfg - Windows 365 - User Settings -          |
| Typ                    | Zeichenfolge                                 |
| Im Portal ausgeblendet | ja (vordefiniert ü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 Standard-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   |
| ------------------------------------------- | ------ |
| Die Standard-E-Mail verwenden               | falsch |
| Eine benutzerdefinierte Nachricht verwenden | wahr   |

#### customMailMessage

Text der Benachrichtigungs-E-Mail.

| Eigenschaft           | Wert                                                                        |
| --------------------- | --------------------------------------------------------------------------- |
| Erforderlich          | falsch                                                                      |
| Standardwert          | Hier die benutzerdefinierte Nachricht 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 Desk, das die E-Mail in ein Ticket umwandelt.

| Eigenschaft           | Wert                          |
| --------------------- | ----------------------------- |
| Erforderlich          | falsch                        |
| Standardwert          | <support@glueckkanja-gab.com> |
| Typ                   | Zeichenfolge                  |
| Anzeigename im Portal | Adresse des 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

Kundenkennzeichen, das 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 Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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.
