Verwenden von PowerShell zum Verbinden von Schichten mit UKG Pro Workforce Management

Artikel
12/20/2024
Gilt für::

Microsoft Teams, Microsoft 365 for frontline workers

Übersicht

Verwenden Sie den Microsoft Teams Schichten-Connector für UKG Pro Workforce Management , um die Schichten-App in Microsoft Teams mit UKG Pro Workforce Management (UKG Pro WFM) zu integrieren. Ihre Mitarbeiter in Service und Produktion können ihre Zeitpläne nahtlos in UKG Pro WFM innerhalb von Schichten anzeigen und verwalten.

In diesem Artikel erfahren Sie, wie Sie powerShell verwenden, um den Connector für die Integration von Schichten in UKG Pro WFM einzurichten und zu konfigurieren.

Zum Einrichten der Verbindung führen Sie ein PowerShell-Skript aus. Das Skript konfiguriert den Connector, wendet Synchronisierungseinstellungen an, erstellt die Verbindung und ordnet UKG Pro WFM-Instanzen (auch WFM-Instanzen genannt) Teams in Teams zu. Synchronisierungseinstellungen bestimmen die in Schichten aktivierten Features und die Zeitplaninformationen, die zwischen UKG Pro WFM und Schichten synchronisiert werden. Zuordnungen definieren die Synchronisierungsbeziehung zwischen Ihren WFM-Instanzen und Teams in Teams. Sie können zu vorhandenen Teams und neuen Teams zuordnen.

Wir stellen zwei Skripts bereit. Sie können entweder ein Skript verwenden, je nachdem, ob Sie vorhandenen Teams zuordnen möchten, oder neue Teams erstellen möchten, die zugeordnet werden sollen.

Sie können mehrere Verbindungen mit jeweils unterschiedlichen Synchronisierungseinstellungen einrichten. Wenn Ihre Organisation beispielsweise über mehrere Standorte mit unterschiedlichen Zeitplananforderungen verfügt, erstellen Sie eine Verbindung mit eindeutigen Synchronisierungseinstellungen für jeden Standort. Denken Sie daran, dass eine WFM-Instanz jeweils nur einem Team zugeordnet werden kann. Wenn eine Instanz bereits einem Team zugeordnet ist, kann sie keinem anderen Team zugeordnet werden.

Mit UKG Pro WFM als Aufzeichnungssystem können Ihre Mitarbeiter in Service und Produktion ihre Zeitpläne und Verfügbarkeit in Schichten auf ihren Geräten effizient verwalten. Manager in Service und Produktion können weiterhin UKG Pro WFM verwenden, um Zeitpläne einzurichten.

Hinweis

Sie können auch den Connector-Assistenten für Schichten im Microsoft 365 Admin Center verwenden, um Schichten mit UKG Pro WFM zu verbinden.

Bevor Sie beginnen

Voraussetzungen

Nehmen Sie sich Zeit, um die Informationen zu überprüfen und alle erforderlichen und Konfigurationsaufgaben in Voraussetzungen und Anforderungen für den Teams Schichten-Connector für UKG Pro Workforce Management auszuführen.

Stellen Sie sicher, dass Sie alle Aufgaben ausführen, bevor Sie die Schritte in diesem Artikel ausführen.

Administratorrolle zum Verwalten des Connectors mithilfe von PowerShell

Sie müssen ein globaler Microsoft 365-Administrator oder ein Shifts-Connectoradministrator sein, um die Schritte in diesem Artikel ausführen zu können.

Die Administratorrolle des Shifts-Connectors ist eine benutzerdefinierte Rolle, die Sie in Microsoft Entra ID erstellen und einem Benutzer zuweisen. Der Name der Rolle muss „Schichten-Connector-Administrator“ sein. Die Rolle muss keine bestimmten Berechtigungen besitzen, allerdings muss beim Erstellen mindestens eine Berechtigung festgelegt werden. Der Dienst basiert darauf, dass der Benutzer über die Rolle verfügt, und ist nicht von den Berechtigungen abhängig.

Weitere Informationen finden Sie unter Erstellen und Zuweisen einer benutzerdefinierten Rolle in Microsoft Entra ID und Zuweisen von Microsoft Entra-Rollen zu Benutzern. Beachten Sie, dass es bis zu 24 Stunden dauern kann, bis die Rolle erstellt und auf einen Benutzer angewendet wird.

Wichtig

Microsoft empfiehlt die Verwendung von Rollen mit den wenigsten Berechtigungen. Dies trägt zur Verbesserung der Sicherheit für Ihre Organisation bei. Globaler Administrator ist eine Rolle mit hohen Berechtigungen, die auf Notfallszenarien beschränkt werden sollte, wenn Sie keine Rolle mit weniger Berechtigungen verwenden können.

Einrichten der Umgebung

Installieren Sie PowerShell, Version 7 oder höher. Eine schrittweise Anleitung finden Sie unter Installieren von PowerShell unter Windows.
Führen Sie PowerShell im Administratormodus aus.
Installieren Sie das Microsoft Graph PowerShell-Modul.
```
Install-Module Microsoft.Graph
Import-Module Microsoft.Graph
```
Vergewissern Sie sich, dass es sich um Version 1.6.1 oder höher handelt.
```
Get-InstalledModule Microsoft.Graph 
```
Installieren Sie das PowerShell-Modul der Microsoft Teams-Vorschauversion.
```
Install-Module -Name MicrosoftTeams -AllowPrerelease -Force
Import-Module MicrosoftTeams 
```
Vergewissern Sie sich, dass es mindestens Version 4.7.0 ist und die Shifts-Connector-Cmdlets enthält.
```
Get-Command -Module MicrosoftTeams -Name *teamsshiftsconnection* 
```
Legen Sie fest, dass PowerShell beendet wird, wenn beim Ausführen des Skripts ein Fehler auftritt.
```
$ErrorActionPreference = "Stop" 
```
Aktivieren Sie die Ausführung von Skripts in Windows.
```
Set-ExecutionPolicy bypass 
```

Mit Teams verbinden

Führen Sie folgendes aus, um eine Verbindung mit Microsoft Teams herzustellen.

Connect-MicrosoftTeams

Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihren Administratoranmeldeinformationen an. Sie sind jetzt für die Ausführung der Skripts in diesem Artikel und der Shifts-Connector-Cmdlets eingerichtet.

Identifizieren der Teams, die Sie zuordnen möchten

Hinweis

Führen Sie diesen Schritt aus, wenn Sie WFM-Instanzen vorhandenen Teams zuordnen. Wenn Sie neue Teams für die Zuordnung erstellen, können Sie diesen Schritt überspringen.

Wechseln Sie im Azure-Portal zur Seite Alle Gruppen, um eine Liste der Team-IDs von Teams in Ihrer Organisation abzurufen.

Notieren Sie sich die Team-IDs der Teams, die Sie zuordnen möchten. Das Skript fordert Sie auf, diese Informationen einzugeben.

Hinweis

Wenn ein oder mehrere Teams über einen vorhandenen Zeitplan verfügen, entfernt das Skript die Zeitpläne aus diesen Teams. Andernfalls werden doppelte Schichten angezeigt.

Ausführen des Skripts

Führen Sie eines der folgenden Skripts aus, je nachdem, ob Sie ein neues Team erstellen oder einem vorhandenen Team zuordnen:

Um eine Verbindung einzurichten, erstellen Sie ein neues Team in Teams, und ordnen Sie dem neuen Team eine WFM-Instanz zu, führen Sie das neue Teams-Skript aus.
Führen Sie das vorhandene Teams-Skript aus, um eine Verbindung einzurichten und WFM-Instanzen vorhandenen Teams in Teams zuzuordnen.

Befolgen Sie die Anweisungen auf dem Bildschirm, wenn Sie das Skript ausführen. Das Skript schließt die folgenden Aktionen ab:

Testen und überprüfen Sie die Verbindung mit UKG Pro WFM mithilfe der Anmeldeinformationen des UKG Pro WFM-Dienstkontos und der von Ihnen eingegebenen Dienst-URLs.
Wenden Sie Synchronisierungseinstellungen an. Diese Einstellungen umfassen die Synchronisierungshäufigkeit (in Minuten) und die Zeitplandaten, die zwischen UKG Pro WFM und Schichten synchronisiert werden. Sie können Zeitplandaten aktivieren, die durch die folgenden Szenarien definiert werden: Shift, SwapRequestOfferShiftRequest, UserShiftPreferences, OpenShift, OpenShiftRequest, TimeOff, . TimeOffRequest

Weitere Informationen finden Sie unter New-ClassificationRuleCollection. Um die Liste der unterstützten Synchronisierungsoptionen für jeden Parameter anzuzeigen, führen Sie Get-CsTeamsShiftsConnectionConnector aus.

Hinweis

Das Skript aktiviert die Synchronisierung für jede unterstützte Synchronisierungsoption. Wenn Sie die Synchronisierungseinstellungen ändern möchten, können Sie dies tun, nachdem die Verbindung eingerichtet wurde. Weitere Informationen finden Sie unter Verwalten Ihrer Schichten-Verbindung mit UKG Pro Workforce Management mithilfe von PowerShell.
Ordnen Sie WFM-Instanzen Ihren Teams in Teams zu.
- Wenn Sie sich für die Ausführung des neuen Teams-Skripts entschieden haben, um neue Teams zu erstellen, basieren die Zuordnungen auf den neuen Teams, die Sie erstellen.
- Wenn Sie das vorhandene Teams-Skript ausführen möchten, um vorhandene Teams zuzuordnen, basieren Zuordnungen auf WFM-Instanz-IDs und Team-IDs, die Sie eingeben. Wenn ein Team über einen vorhandenen Zeitplan verfügt, entfernt das Skript alle Zeitplandaten.
Nachdem Sie das Skript ausgeführt haben, wird in einer Erfolgsmeldung bestätigt, ob Die Verbindung erfolgreich eingerichtet wurde.

Verwalten der Verbindung

Nachdem eine Verbindung eingerichtet wurde, können Sie sie im Microsoft 365 Admin Center oder mithilfe von PowerShell verwalten und ändern.

Verwenden des Microsoft 365 Admin Centers

Auf der Seite Connectorverwaltung werden jede Verbindung, die Sie eingerichtet haben, sowie Informationen wie Integritätsstatus und Details zum Synchronisierungsintervall aufgelistet. Sie können auch auf den Assistenten zugreifen, um Änderungen an Ihren Verbindungen vorzunehmen. Beispielsweise können Sie Synchronisierungseinstellungen und Teamzuordnungen aktualisieren.

Weitere Informationen finden Sie unter Verwenden des Microsoft 365 Admin Centers zum Verwalten Ihrer Schichten-Verbindung mit UKG Pro Workforce Management.

PowerShell verwenden

Sie können PowerShell verwenden, um einen Fehlerbericht anzuzeigen, Verbindungseinstellungen zu ändern, die Synchronisierung zu deaktivieren und vieles mehr. Eine schritt-für-Schritt-Anleitung finden Sie unter Verwenden von PowerShell zum Verwalten Ihrer Schichten-Verbindung mit UKG Pro Workforce Management.

Skripts

Einrichten einer Verbindung und Erstellen eines neuen Teams

#Map WFM instances to teams script
Write-Output "Map WFM sites to teams"
Start-Sleep 1

#Ensure Teams module is at least version x
Write-Output "Checking Teams module version"
try {
    Get-InstalledModule -Name "MicrosoftTeams" -MinimumVersion 5.2.0
} catch {
    throw
}

#Connect to MS Graph
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"

#List connector types available
Write-Output "Listing connector types available"
$UkgId = "95BF2848-2DDA-4425-B0EE-D62AEED4C0A0"
$connectors = Get-CsTeamsShiftsConnectionConnector
Write-Output $connectors
$Ukg = $connectors | Where-Object {$_.Id -match $UkgId}
if ($NULL -eq $Ukg) {
    throw "UKG Dimensions not currently supported"
}

#Prompt for entering of WFM username and password
$WfmUserName = Read-Host -Prompt 'Input your UKG account username'
$WfmPwd = Read-Host -Prompt 'Input your UKG account password' -AsSecureString
$plainPwd =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($WfmPwd))

#Test connection settings
Write-Output "Testing connection settings"
$ConnectionName = Read-Host -Prompt 'Input connection name'
$apiUrl = Read-Host -Prompt 'Input connector api url'
$ssoUrl = Read-Host -Prompt 'Input connector sso url'
$clientId = Read-Host -Prompt 'Input connector client id'
$AppKey = Read-Host -Prompt 'Input your app key' -AsSecureString
$plainKey =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($AppKey))
$ClientSecret = Read-Host -Prompt 'Input your client secret' -AsSecureString
$plainSecret =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($ClientSecret))

$testResult = Test-CsTeamsShiftsConnectionValidate `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })
if ($NULL -ne $testResult.Code) {
    Write-Output $testResult
    throw "Validation failed, conflict found"
}
Write-Output "Test complete, no conflicts found"

#Create a connection
Write-Output "Creating a connection"
$ConnectionResponse = New-CsTeamsShiftsConnection `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })

$ConnectionId = $ConnectionResponse.Id
if ($null -ne $ConnectionId){
    Write-Output "Successfully created connection"
} else {
    throw "Connection creation failed"
}

#Create a connection instance
Write-Output "Creating a connection instance"
$designatedActorName = Read-Host -Prompt "Input Microsoft 365 System Account (person@contoso.com)"
$designator = Get-MgUser -UserId $designatedActorName
$teamsUserId = $designator.Id
$syncFreq = Read-Host -Prompt "Input sync frequency in minutes"
$InstanceName = Read-Host -Prompt "Input connection instance name"

#Read sync scenarios for connection instance
function GetSyncScenarioSetting {
    param (
        $SettingName
    )
    $TwoWay = New-Object System.Management.Automation.Host.ChoiceDescription '&TwoWay', 'TwoWay'
    $Disabled = New-Object System.Management.Automation.Host.ChoiceDescription '&Disabled', 'Disabled'
    $FromWfmToShifts = New-Object System.Management.Automation.Host.ChoiceDescription '&FromWfmToShifts', 'FromWfmToShifts'
    $options = [System.Management.Automation.Host.ChoiceDescription[]]($TwoWay, $Disabled, $FromWfmToShifts)
    $result = $host.ui.PromptForChoice("Set sync scenario for $SettingName", "", $options, 0)

    switch ($result)
    {
        0 { return "TwoWay" }
        1 { return "Disabled" }
        2 { return "FromWfmToShifts" }
    }
}
$SyncScenarioOfferShiftRequest = GetSyncScenarioSetting "Offer Shift Request"
$SyncScenarioOpenShift = GetSyncScenarioSetting "Open Shift"
$SyncScenarioOpenShiftRequest = GetSyncScenarioSetting "Open Shift Request"
$SyncScenarioShift = GetSyncScenarioSetting "Shift"
$SyncScenarioSwapRequest = GetSyncScenarioSetting "Swap Request"
$SyncScenarioTimeCard = GetSyncScenarioSetting "Time Card"
$SyncScenarioTimeOff = GetSyncScenarioSetting "Time Off"
$SyncScenarioTimeOffRequest = GetSyncScenarioSetting "Time Off Request"
$SyncScenarioUserShiftPreference = GetSyncScenarioSetting "User Shift Preferences"

#Read admin email list
[psobject[]]$AdminEmailList = @()
while ($true){
    $AdminEmail = Read-Host -Prompt "Enter admin's email to receive error report"
    $AdminEmailList += $AdminEmail
    $title    = 'Adding another email'
    $question = 'Would you like to add another admin email?'
    $choices  = '&Yes', '&No'
    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$InstanceResponse = New-CsTeamsShiftsConnectionInstance `
    -ConnectionId $ConnectionId `
    -ConnectorAdminEmail $AdminEmailList `
    -DesignatedActorId $teamsUserId `
    -Name $InstanceName `
    -SyncFrequencyInMin $syncFreq `
    -SyncScenarioOfferShiftRequest $SyncScenarioOfferShiftRequest `
    -SyncScenarioOpenShift $SyncScenarioOpenShift `
    -SyncScenarioOpenShiftRequest $SyncScenarioOpenShiftRequest `
    -SyncScenarioShift $SyncScenarioShift `
    -SyncScenarioSwapRequest $SyncScenarioSwapRequest `
    -SyncScenarioTimeCard $SyncScenarioTimeCard `
    -SyncScenarioTimeOff $SyncScenarioTimeOff `
    -SyncScenarioTimeOffRequest $SyncScenarioTimeOffRequest `
    -SyncScenarioUserShiftPreference $SyncScenarioUserShiftPreference

$InstanceId = $InstanceResponse.id
if ($null -ne $InstanceId){
    Write-Output "Success"
} else {
    throw "Connector instance creation failed"
}

#Keep mapping teams until user stops it
$mappings=@()
while ($true)
{
    #Create a new Teams team with owner set to system account and name set to the site name
    Write-Output "Creating a Teams team"
    $teamsTeamName = Read-Host -Prompt "Input the Teams team name"
    $Team = New-Team -DisplayName $teamsTeamName -Visibility "Public" -Owner $teamsUserId
    Write-Output "Successfully created a team"
    $TeamsTeamId=$Team.GroupId

    #Retrieve the list of wfm locations
    Write-Output "Listing the WFM team sites"
    $WfmTeamIds = Get-CsTeamsShiftsConnectionWfmTeam -ConnectorInstanceId $InstanceId
    Write-Output $WfmTeamIds
    if (($NULL -ne $WfmTeamIds) -and ($WfmTeamIds.Count -gt 0)){
        [System.String]$WfmTeamId = Read-Host -Prompt "Input the ID of WFM team you want to map"
    }
    else {
        throw "The WfmTeamId list is null or empty"
    }

    #Retrieve the list of WFM users and their roles
    Write-Output "Listing WFM users and roles"
    $WFMUsers = Get-CsTeamsShiftsConnectionWfmUser -ConnectorInstanceId $InstanceId -WfmTeamId $WfmTeamId
    Write-Output $WFMUsers

    #Add users to the Team for Shifts
    Write-Output "Adding users to Teams team"
    $currentUser = Read-Host -Prompt "Input the current user's user name or AAD ID"
    Add-TeamUser -GroupId $TeamsTeamId -User $currentUser -Role Owner
    $failedWfmUsers=@()
    foreach ($user in $WFMUsers) {
        try {
        $userEmail = $user.Name + "@" +$domain
        Add-TeamUser -GroupId $TeamsTeamId -User $userEmail
        } catch {
            $failedWfmUsers+=$user
        }
    }
    if($failedWfmUsers.Count -gt 0){
        Write-Output "There are WFM users not existed in Teams tenant:"
        Write-Output $failedWfmUsers
    }

    #Enable scheduling in the group
    $RequestBody = @{
        Enabled = $true
        TimeZone = "America/Los_Angeles"
    }
    $teamUpdateUrl="https://graph.microsoft.com/v1.0/teams/"+$TeamsTeamId+"/schedule"
    Invoke-MgGraphRequest -Uri $teamUpdateUrl -Method PUT -Body $RequestBody

    #Create a mapping of the new team to the instance
    Write-Output "Create a mapping of the new team to the site"
    $TimeZone = Read-Host -Prompt "Input the time zone of team mapping"
    $mapping = @{
        teamId = $TeamsTeamId
        wfmTeamId = $WfmTeamId
        timeZone = $TimeZone
        }
    $mappings += , $mapping

    $title    = 'Connecting another team'
    $question = 'Would you like to connect another team?'
    $choices  = '&Yes', '&No'

    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$batchMappingResponse = New-CsTeamsShiftsConnectionBatchTeamMap -ConnectorInstanceId $InstanceId -TeamMapping @($mappings)
if ($null -ne $batchMappingResponse.OperationId){
    "The mapping has begun asynchronously. To query mapping results run Get-CsTeamsShiftsConnectionOperation with the operation Id."
}
else {
    throw "The mapping has failed due to validation errors."
}
Write-Output $batchMappingResponse

Remove-TeamUser -GroupId $TeamsTeamId -User $currentUser -Role Owner
Disconnect-MgGraph

Einrichten einer Verbindung und Zuordnen eines vorhandenen Teams

#Map WFM instances to existing teams script
Write-Host "Map WFM sites to existing teams"
Start-Sleep 1

#Ensure Teams module is at least version x
Write-Host "Checking Teams module version"
try {
    Get-InstalledModule -Name "MicrosoftTeams" -MinimumVersion 5.2.0
} catch {
    throw
}

#Connect to MS Graph
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"

#List connector types available
Write-Output "Listing connector types available"
$UkgId = "95BF2848-2DDA-4425-B0EE-D62AEED4C0A0"
$connectors = Get-CsTeamsShiftsConnectionConnector
Write-Output $connectors
$Ukg = $connectors | Where-Object {$_.Id -match $UkgId}
if ($NULL -eq $Ukg) {
    throw "UKG Dimensions not currently supported"
}

#Prompt for entering of WFM username and password
$WfmUserName = Read-Host -Prompt 'Input your UKG account username'
$WfmPwd = Read-Host -Prompt 'Input your UKG account password' -AsSecureString
$plainPwd =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($WfmPwd))

#Test connection settings
Write-Output "Testing connection settings"
$ConnectionName = Read-Host -Prompt 'Input connection name'
$apiUrl = Read-Host -Prompt 'Input connector api url'
$ssoUrl = Read-Host -Prompt 'Input connector sso url'
$clientId = Read-Host -Prompt 'Input connector client id'
$AppKey = Read-Host -Prompt 'Input your app key' -AsSecureString
$plainKey =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($AppKey))
$ClientSecret = Read-Host -Prompt 'Input your client secret' -AsSecureString
$plainSecret =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($ClientSecret))

$testResult = Test-CsTeamsShiftsConnectionValidate `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })
if ($NULL -ne $testResult.Code) {
    Write-Output $testResult
    throw "Validation failed, conflict found"
}
Write-Output "Test complete, no conflicts found"

#Create a connection
Write-Output "Creating a connection"
$ConnectionResponse = New-CsTeamsShiftsConnection `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })

$ConnectionId = $ConnectionResponse.Id
if ($null -ne $ConnectionId){
    Write-Output "Successfully created connection"
} else {
    throw "Connection creation failed"
}

#Create a connection instance
Write-Output "Creating a connection instance"
$designatedActorName = Read-Host -Prompt "Input Microsoft 365 System Account (person@contoso.com)"
$designator = Get-MgUser -UserId $designatedActorName
$teamsUserId = $designator.Id
$syncFreq = Read-Host -Prompt "Input sync frequency in minutes"
$InstanceName = Read-Host -Prompt "Input connection instance name"

#Read sync scenarios for connection instance
function GetSyncScenarioSetting {
    param (
        $SettingName
    )
    $TwoWay = New-Object System.Management.Automation.Host.ChoiceDescription '&TwoWay', 'TwoWay'
    $Disabled = New-Object System.Management.Automation.Host.ChoiceDescription '&Disabled', 'Disabled'
    $FromWfmToShifts = New-Object System.Management.Automation.Host.ChoiceDescription '&FromWfmToShifts', 'FromWfmToShifts'
    $options = [System.Management.Automation.Host.ChoiceDescription[]]($TwoWay, $Disabled, $FromWfmToShifts)
    $result = $host.ui.PromptForChoice("Set sync scenario for $SettingName", "", $options, 0)

    switch ($result)
    {
        0 { return "TwoWay" }
        1 { return "Disabled" }
        2 { return "FromWfmToShifts" }
    }
}
$SyncScenarioOfferShiftRequest = GetSyncScenarioSetting "Offer Shift Request"
$SyncScenarioOpenShift = GetSyncScenarioSetting "Open Shift"
$SyncScenarioOpenShiftRequest = GetSyncScenarioSetting "Open Shift Request"
$SyncScenarioShift = GetSyncScenarioSetting "Shift"
$SyncScenarioSwapRequest = GetSyncScenarioSetting "Swap Request"
$SyncScenarioTimeCard = GetSyncScenarioSetting "Time Card"
$SyncScenarioTimeOff = GetSyncScenarioSetting "Time Off"
$SyncScenarioTimeOffRequest = GetSyncScenarioSetting "Time Off Request"
$SyncScenarioUserShiftPreference = GetSyncScenarioSetting "User Shift Preferences"

#Read admin email list
[psobject[]]$AdminEmailList = @()
while ($true){
    $AdminEmail = Read-Host -Prompt "Enter admin's email to receive error report"
    $AdminEmailList += $AdminEmail
    $title    = 'Adding another email'
    $question = 'Would you like to add another admin email?'
    $choices  = '&Yes', '&No'
    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$InstanceResponse = New-CsTeamsShiftsConnectionInstance `
    -ConnectionId $ConnectionId `
    -ConnectorAdminEmail $AdminEmailList `
    -DesignatedActorId $teamsUserId `
    -Name $InstanceName `
    -SyncFrequencyInMin $syncFreq `
    -SyncScenarioOfferShiftRequest $SyncScenarioOfferShiftRequest `
    -SyncScenarioOpenShift $SyncScenarioOpenShift `
    -SyncScenarioOpenShiftRequest $SyncScenarioOpenShiftRequest `
    -SyncScenarioShift $SyncScenarioShift `
    -SyncScenarioSwapRequest $SyncScenarioSwapRequest `
    -SyncScenarioTimeCard $SyncScenarioTimeCard `
    -SyncScenarioTimeOff $SyncScenarioTimeOff `
    -SyncScenarioTimeOffRequest $SyncScenarioTimeOffRequest `
    -SyncScenarioUserShiftPreference $SyncScenarioUserShiftPreference

$InstanceId = $InstanceResponse.id
if ($null -ne $InstanceId){
    Write-Output "Success"
} else {
    throw "Connector instance creation failed"
}

#Keep mapping teams until user stops it
$mappings=@()
while ($true)
{
    $TeamsTeamId = Read-Host -Prompt "Input the ID of the Teams team to be mapped"
    #Clear schedule of the Teams team
    Write-Host "Clear schedule of the existing team"

    $entityTypeString = Read-Host -Prompt 'Input the entity types of clear schedule'
    $Delimiters = ",", ".", ":", ";", " ", "`t"
    $entityType = $entityTypeString -Split {$Delimiters -contains $_}
    $entityType = $entityType.Trim()
    $entityType = $entityType.Split('',[System.StringSplitOptions]::RemoveEmptyEntries)
    Remove-CsTeamsShiftsScheduleRecord -TeamId $TeamsTeamId -ClearSchedulingGroup:$True -EntityType $entityType

    #Retrieve the list of wfm locations
    Write-Output "Listing the WFM team sites"
    $WfmTeamIds = Get-CsTeamsShiftsConnectionWfmTeam -ConnectorInstanceId $InstanceId
    Write-Output $WfmTeamIds
    if (($NULL -ne $WfmTeamIds) -and ($WfmTeamIds.Count -gt 0)){
        [System.String]$WfmTeamId = Read-Host -Prompt "Input the ID of WFM team you want to map"
    }
    else {
        throw "The WfmTeamId list is null or empty"
    }

    #Retrieve the list of WFM users and their roles
    Write-Output "Listing WFM users and roles"
    $WFMUsers = Get-CsTeamsShiftsConnectionWfmUser -ConnectorInstanceId $InstanceId -WfmTeamId $WfmTeamId
    Write-Output $WFMUsers

    #Create a mapping of the existing team to the instance
    Write-Host "Create a mapping of the existing team to the site"
    $TimeZone = Read-Host -Prompt "Input the time zone of team mapping"
    $mapping = @{
        teamId = $TeamsTeamId
        wfmTeamId = $WfmTeamId
        timeZone = $TimeZone
        }
    $mappings += , $mapping

    $title    = 'Connecting another team'
    $question = 'Would you like to connect another team?'
    $choices  = '&Yes', '&No'

    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$batchMappingResponse = New-CsTeamsShiftsConnectionBatchTeamMap -ConnectorInstanceId $InstanceId -TeamMapping @($mappings)
if ($null -ne $batchMappingResponse.OperationId){
    "The mapping has begun asynchronously. To query mapping results run Get-CsTeamsShiftsConnectionOperation with the operation Id."
}
else {
    throw "The mapping has failed due to validation errors."
}
Write-Output $batchMappingResponse

Disconnect-MgGraph

Cmdlets für Schichten-Connectors

Hilfe zu Cmdlets für Schichten-Connectors, einschließlich der Cmdlets, die in den Skripts verwendet werden, finden Sie in der Microsoft Teams PowerShell-Cmdlet-Referenz nach CsTeamsShiftsConnection. Hier finden Sie Links zu einigen häufig verwendeten Cmdlets, gruppiert nach Kategorie:

Verbindungen

Anmeldeinformationen für WFM-Systeme

Test-CsTeamsShiftsConnectionValidate

Synchronisierungsoptionen für unterstützte Szenarien

Get-CsTeamsShiftsConnectionConnector

Entfernen von Zeitplandaten

Remove-CsTeamsShiftsScheduleRecord

Verbindungsinstanzen

Benutzerzuordnung und erfolgreiche Synchronisierung

Teamzuordnung

Vorgangs-ID

Get-CsTeamsShiftsConnectionOperation

Fehlerberichte

Get-CsTeamsShiftsConnectionErrorReport

Freigeben über

Verwenden von PowerShell zum Verbinden von Schichten mit UKG Pro Workforce Management

Übersicht

Bevor Sie beginnen

Voraussetzungen

Administratorrolle zum Verwalten des Connectors mithilfe von PowerShell

Einrichten der Umgebung

Mit Teams verbinden

Identifizieren der Teams, die Sie zuordnen möchten

Ausführen des Skripts

Verwalten der Verbindung

Verwenden des Microsoft 365 Admin Centers

PowerShell verwenden

Skripts

Einrichten einer Verbindung und Erstellen eines neuen Teams

Einrichten einer Verbindung und Zuordnen eines vorhandenen Teams

Cmdlets für Schichten-Connectors

Feedback

Zusätzliche Ressourcen

Freigeben über

Verwenden von PowerShell zum Verbinden von Schichten mit UKG Pro Workforce Management

Übersicht

Bevor Sie beginnen

Voraussetzungen

Administratorrolle zum Verwalten des Connectors mithilfe von PowerShell

Einrichten der Umgebung

Mit Teams verbinden

Identifizieren der Teams, die Sie zuordnen möchten

Ausführen des Skripts

Verwalten der Verbindung

Verwenden des Microsoft 365 Admin Centers

PowerShell verwenden

Skripts

Einrichten einer Verbindung und Erstellen eines neuen Teams

Einrichten einer Verbindung und Zuordnen eines vorhandenen Teams

Cmdlets für Schichten-Connectors

Verwandte Artikel

Feedback

Zusätzliche Ressourcen