Get-CsTeamsShiftsConnectionInstance

Module:

MicrosoftTeamsPowerShell

This cmdlet returns the list of existing connection instances. It can also return the configuration details for a given connection instance.

Syntax

Get-CsTeamsShiftsConnectionInstance
   [-Break]
   [-HttpPipelineAppend <SendAsyncStep[]>]
   [-HttpPipelinePrepend <SendAsyncStep[]>]
   [-Proxy <Uri>]
   [-ProxyCredential <PSCredential>]
   [-ProxyUseDefaultCredentials]
   [<CommonParameters>]

Get-CsTeamsShiftsConnectionInstance
   -ConnectorInstanceId <String>
   [-Break]
   [-HttpPipelineAppend <SendAsyncStep[]>]
   [-HttpPipelinePrepend <SendAsyncStep[]>]
   [-Proxy <Uri>]
   [-ProxyCredential <PSCredential>]
   [-ProxyUseDefaultCredentials]
   [<CommonParameters>]

Get-CsTeamsShiftsConnectionInstance
   -InputObject <IConfigApiBasedCmdletsIdentity>
   [-Break]
   [-HttpPipelineAppend <SendAsyncStep[]>]
   [-HttpPipelinePrepend <SendAsyncStep[]>]
   [-Proxy <Uri>]
   [-ProxyCredential <PSCredential>]
   [-ProxyUseDefaultCredentials]
   [<CommonParameters>]

Description

This cmdlet returns the list of existing connections. It can also return the configuration details for a given connection instance.

Examples

Example 1

PS C:\> Get-CsTeamsShiftsConnectionInstance | Format-List

ConnectionId                    : a2d1b091-5140-4dd2-987a-98a8b5338744
ConnectorAdminEmail             : {testAdmin@contoso.com}
ConnectorId                     : 95BF2848-2DDA-4425-B0EE-D62AEED4C0A0
CreatedDateTime                 : 07/04/2023 10:53:59
DesignatedActorId               : ec1a4edb-1a5f-4b2d-b2a4-37aaf3acd231
Etag                            : "4f00c221-0000-0400-0000-642ff6480000"
Id                              : WCI-b58d7a98-ab2c-473f-99a5-e0627d54c062
LastModifiedDateTime            : 07/04/2023 10:53:59
Name                            : My connection instance 1
State                           : Active
SyncFrequencyInMin              : 10
SyncScenarioOfferShiftRequest   : FromWfmToShifts
SyncScenarioOpenShift           : FromWfmToShifts
SyncScenarioOpenShiftRequest    : FromWfmToShifts
SyncScenarioShift               : FromWfmToShifts
SyncScenarioSwapRequest         : FromWfmToShifts
SyncScenarioTimeCard            : FromWfmToShifts
SyncScenarioTimeOff             : FromWfmToShifts
SyncScenarioTimeOffRequest      : FromWfmToShifts
SyncScenarioUserShiftPreference : FromWfmToShifts
TenantId                        : dfd24b34-ccb0-47e1-bdb7-e49db9c7c14a
WorkforceIntegrationId          : WFI_2ab21992-b9b1-464a-b9cd-e0de1fac95b1

ConnectionId                    : a2d1b091-5140-4dd2-987a-98a8b5338744
ConnectorAdminEmail             : {}
ConnectorId                     : 95BF2848-2DDA-4425-B0EE-D62AEED4C0A0
CreatedDateTime                 : 07/04/2023 10:54:01
DesignatedActorId               : ec1a4edb-1a5f-4b2d-b2a4-37aab6ebd231
Etag                            : "4f005d22-0000-0400-0000-642ff64a0000"
Id                              : WCI-eba2865f-6cac-46f9-8733-e0631a4536e1
LastModifiedDateTime            : 07/04/2023 10:54:01
Name                            : My connection instance 2
State                           : Active
SyncFrequencyInMin              : 30
SyncScenarioOfferShiftRequest   : FromWfmToShifts
SyncScenarioOpenShift           : FromWfmToShifts
SyncScenarioOpenShiftRequest    : FromWfmToShifts
SyncScenarioShift               : FromWfmToShifts
SyncScenarioSwapRequest         : Disabled
SyncScenarioTimeCard            : Disabled
SyncScenarioTimeOff             : FromWfmToShifts
SyncScenarioTimeOffRequest      : FromWfmToShifts
SyncScenarioUserShiftPreference : Disabled
TenantId                        : dfd24b34-ccb0-47e1-bdb7-e49db9c7c14a
WorkforceIntegrationId          : WFI_6b225907-b476-4d40-9773-08b86db7b11b

Returns the list of connection instances.

Example 2

PS C:\> $ci = Get-CsTeamsShiftsConnectionInstance -ConnectorInstanceId WCI-78F5116E-9098-45F5-B595-1153DF9D6F70
PS C:\> $ci.ToJsonString()

{
  "syncScenarios": {
    "offerShiftRequest": "FromWfmToShifts",
    "openShift": "FromWfmToShifts",
    "openShiftRequest": "FromWfmToShifts",
    "shift": "FromWfmToShifts",
    "swapRequest": "Disabled",
    "timeCard": "Disabled",
    "timeOff": "FromWfmToShifts",
    "timeOffRequest": "FromWfmToShifts",
    "userShiftPreferences": "Disabled"
  },
  "id": "WCI-78F5116E-9098-45F5-B595-1153DF9D6F70",
  "tenantId": "dfd24b34-ccb0-47e1-bdb7-e49db9c7c14a",
  "connectionId": "a2d1b091-5140-4dd2-987a-98a8b5338744",
  "connectorAdminEmails": [ ],
  "connectorId": "95BF2848-2DDA-4425-B0EE-D62AEED4C0A0",
  "designatedActorId": "ec1a4edb-1a5f-4b2d-b2a4-37aab6ebd231",
  "name": "My connection instance 2",
  "syncFrequencyInMin": 30,
  "workforceIntegrationId": "WFI_6b225907-b476-4d40-9773-08b86db7b11b",
  "etag": "\"4f005d22-0000-0400-0000-642ff64a0000\"",
  "createdDateTime": "2023-04-07T10:54:01.8170000Z",
  "lastModifiedDateTime": "2023-04-07T10:54:01.8170000Z",
  "state": "Active"
}

Returns the connection instance with the specified -ConnectorInstanceId.

Parameters

-Break

Wait for .NET debugger to attach

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectorInstanceId

The connector instance id

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpPipelineAppend

SendAsync Pipeline Steps to be appended to the front of the pipeline

Type:	SendAsyncStep[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpPipelinePrepend

SendAsync Pipeline Steps to be prepended to the front of the pipeline

Type:	SendAsyncStep[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Identity Parameter

Type:	IConfigApiBasedCmdletsIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

The URI for the proxy server to use

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProxyCredential

Credentials for a proxy server to use for the remote call

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProxyUseDefaultCredentials

Use the default credentials for the proxy

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.IConfigApiBasedCmdletsIdentity

Outputs

Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.IConnectorInstanceResponse

Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.IErrorDetailsResponse

Related Links

• New-CsTeamsShiftsConnectionInstance
• Set-CsTeamsShiftsConnectionInstance
• Remove-CsTeamsShiftsConnectionInstance