TechDocs › Powershell-Erweiterung › Konfiguration

AnyDevice/Softphone Leitungen#

Add-XpFMCConfiguration#

Fügt AnyDevice/Softphone Leitungen für die angegebenen Benutzer hinzu.

Syntax#

Add-XpFMCConfiguration -GatewayName <string> -Location <XpLocation> -Users <XpUser[]> [-Standalone <bool>] [-Timeout <int>]

Add-XpFMCConfiguration -GatewayName <string> -LocationName <string> -Users <XpUser[]> [-Standalone <bool>] [-Timeout <int>]

Beschreibung#

Das Add-XpFMCConfiguration Cmdlet fügt AnyDevice/Softphone Leitungen für die angegebenen Benutzer hinzu.

Mit dem -Standalone Parameter kann festgelegt werden, ob AnyDevice / Softphone eigenständig verwenden konfiguriert werden soll.

Nach der Operation sollte die aktive Benutzertabelle überprüft werden, indem die Users-Tabelle im Rückgabeobjekt inspiziert wird.

Parameter#

  • -GatewayName <string>

    • Der Name des Gateways, für das die AnyDevice/Softphone Leitungen hinzugefügt werden sollen

    • Dieser Parameter ist erforderlich

  • -Location <XpLocation>

    • Das Standort-Objekt, das die AnyDevice/Softphone Leitungen erhalten soll

    • Kann mit Get-XpLocations abgerufen werden

    • Erforderlich: Entweder dieser Parameter ODER ``-LocationName`` muss angegeben werden

  • -LocationName <string>

    • Der Name des Standorts als String

    • Alternative zu -Location, wenn nur der Standortname als String verfügbar ist

    • Erforderlich: Entweder dieser Parameter ODER ``-Location`` muss angegeben werden

  • -Users <XpUser[]>

    • Array von Benutzer-Objekten, für die die AnyDevice/Softphone Leitungen hinzugefügt werden sollen

    • Kann mit Get-XpUsers abgerufen werden

    • Dieser Parameter ist erforderlich

  • -Standalone <bool>
  • -Timeout <int>

    • Zeitüberschreitung in Millisekunden

    • Dieser Parameter ist optional

Eingaben#

Keine Pipeline-Eingabe unterstützt.

Ausgaben#

System.Object

Das Cmdlet gibt ein Objekt zurück, das die resultierende Benutzertabelle enthält. Die Benutzertabelle kann über $result.Param.Users.Tables["Users"] abgerufen werden.

Beispiele#

  1. AnyDevice/Softphone Leitungen für bestimmte Benutzer hinzufügen:

    PS C:\Windows\system32> $users = Get-XpUsers -UserName "max.mustermann", "erika.musterfrau"
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn
PS C:\Windows\system32> $r = Add-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  2. AnyDevice/Softphone Leitungen für Benutzer einer AD-Gruppe hinzufügen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Firma_07
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn
PS C:\Windows\system32> $r = Add-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  3. AnyDevice / Softphone eigenständig verwenden mit Standortnamen hinzufügen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Vertrieb
PS C:\Windows\system32> $r = Add-XpFMCConfiguration -GatewayName OSBiz7 -LocationName "Paderborn" -Users $users -Standalone $true
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  4. AnyDevice/Softphone Leitungen nur für neu synchronisierte Benutzer nach AD-Konnektor-Lauf hinzufügen

    Bemerkung

    Das vollständige Skript ist verfügbar als Add-FMCForNewUsers.ps1

    Falls die Fehlermeldung „cannot be loaded because running scripts is disabled on this system“ erscheint, kann die Execution Policy temporär geändert werden:

    PowerShell (als Administrator):
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

    Oder das Skript direkt ausführen mit:

    PowerShell -ExecutionPolicy Bypass -File .\Add-FMCForNewUsers.ps1 -ConnectorName "Name" -LocationName "Ort" -GatewayName "Gateway"

    Schritt 1: Bestehende Benutzer vor dem Konnektor-Lauf erfassen:

    PS C:\Windows\system32> $beforeUsers = Get-XpUsers | Select-Object -Property AccountName
PS C:\Windows\system32> Write-Host "User count before connector: $($beforeUsers.Count)"

    Schritt 2: AD-Konnektor starten:

    PS C:\Windows\system32> Start-XpConnectors "MeinADKonnektor"
PS C:\Windows\system32> Write-Host "AD connector started. Waiting for completion..."

    Schritt 3: Warten bis Konnektor fertig ist:

    PS C:\Windows\system32> Start-Sleep -Seconds 30

    Schritt 4: Alle Benutzer nach dem Konnektor-Lauf abrufen:

    PS C:\Windows\system32> $afterUsers = Get-XpUsers
PS C:\Windows\system32> Write-Host "User count after connector: $($afterUsers.Count)"

    Schritt 5: NUR die neuen Benutzer identifizieren (Differenz):

    PS C:\Windows\system32> $newUsers = $afterUsers | Where-Object {$_.AccountName -notin $beforeUsers.AccountName}

    Schritt 6: AnyDevice/Softphone Leitungen nur für neue Benutzer konfigurieren:

    PS C:\Windows\system32> if ($newUsers.Count -eq 0) {
PS C:\Windows\system32>     Write-Host "No new users found."
PS C:\Windows\system32> } else {
PS C:\Windows\system32>     Write-Host "New users found: $($newUsers.Count)"
PS C:\Windows\system32>     $newUsers | Format-Table AccountName, FirstName, LastName
PS C:\Windows\system32>
PS C:\Windows\system32>     $loc = Get-XpLocations "Paderborn"
PS C:\Windows\system32>     $r = Add-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $newUsers
PS C:\Windows\system32>
PS C:\Windows\system32>     Write-Host "AnyDevice/Softphone configuration completed."
PS C:\Windows\system32>     $r.Param.Users.Tables["Users"] | Format-List *
PS C:\Windows\system32> }

    Hinweis

    Dieser Workflow ist besonders nützlich beim Onboarding neuer Mitarbeiter, da nur neu synchronisierte Benutzer automatisch AnyDevice/Softphone Leitungen erhalten, während bestehende Konfigurationen unverändert bleiben.

Warnung

Nach dem Hinzufügen von AnyDevice/Softphone Leitungen sollte die aktive Benutzertabelle überprüft werden, um sicherzustellen, dass die Leitungen korrekt konfiguriert wurden.

Get-XpFMCConfiguration#

Ruft die aktuellen AnyDevice/Softphone Leitungen für die angegebenen Benutzer ab.

Syntax#

Get-XpFMCConfiguration -GatewayName <string> -Location <XpLocation> -Users <XpUser[]> [-Timeout <int>]

Get-XpFMCConfiguration -GatewayName <string> -LocationName <string> -Users <XpUser[]> [-Timeout <int>]

Beschreibung#

Das Get-XpFMCConfiguration Cmdlet ruft die aktuellen AnyDevice/Softphone Leitungen für die angegebenen Benutzer ab.

Das zurückgegebene Objekt enthält die resultierende Benutzertabelle, die über $result.Param.Users.Tables["Users"] abgerufen werden kann.

Parameter#

  • -GatewayName <string>

    • Der Name des Gateways, von dem die AnyDevice/Softphone Leitungen abgerufen werden sollen

    • Dieser Parameter ist erforderlich

  • -Location <XpLocation>

    • Das Standort-Objekt, dessen AnyDevice/Softphone Leitungen abgerufen werden sollen

    • Kann mit Get-XpLocations abgerufen werden

    • Erforderlich: Entweder dieser Parameter ODER ``-LocationName`` muss angegeben werden

  • -LocationName <string>

    • Der Name des Standorts als String

    • Alternative zu -Location, wenn nur der Standortname als String verfügbar ist

    • Erforderlich: Entweder dieser Parameter ODER ``-Location`` muss angegeben werden

  • -Users <XpUser[]>

    • Array von Benutzer-Objekten, deren AnyDevice/Softphone Leitungen abgerufen werden sollen

    • Kann mit Get-XpUsers abgerufen werden

    • Dieser Parameter ist erforderlich

  • -Timeout <int>

    • Zeitüberschreitung in Millisekunden

    • Dieser Parameter ist optional

Eingaben#

Keine Pipeline-Eingabe unterstützt.

Ausgaben#

Das Cmdlet gibt ein Objekt zurück, das die aktuelle Benutzertabelle enthält. Die Benutzertabelle kann über $result.Param.Users.Tables["Users"] abgerufen werden.

Beispiele#

  1. Aktuelle AnyDevice/Softphone Leitungen für bestimmte Benutzer abrufen:

    PS C:\Windows\system32> $users = Get-XpUsers -UserName "max.mustermann"
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn
PS C:\Windows\system32> $r = Get-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  2. Aktuelle AnyDevice/Softphone Leitungen für eine AD-Gruppe abrufen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Firma_07
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn
PS C:\Windows\system32> $r = Get-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  3. AnyDevice/Softphone Leitungen mit Standortnamen abrufen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Vertrieb
PS C:\Windows\system32> $r = Get-XpFMCConfiguration -GatewayName OSBiz7 -LocationName "Paderborn" -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

Hinweis

Verwenden Sie dieses Cmdlet, um die aktiven AnyDevice/Softphone Leitungen nach jeder Operation (Add/Remove) zu überprüfen.

Remove-XpFMCConfiguration#

Entfernt AnyDevice/Softphone Leitungen für die angegebenen Benutzer.

Syntax#

Remove-XpFMCConfiguration -GatewayName <string> -Location <XpLocation> -Users <XpUser[]> [-Timeout <int>]

Remove-XpFMCConfiguration -GatewayName <string> -LocationName <string> -Users <XpUser[]> [-Timeout <int>]

Beschreibung#

Das Remove-XpFMCConfiguration Cmdlet entfernt die AnyDevice/Softphone Leitungen für die angegebenen Benutzer.

Nach der Operation sollte die aktive Benutzertabelle überprüft werden, indem die Users-Tabelle im Rückgabeobjekt inspiziert wird, um sicherzustellen, dass die Leitungen erfolgreich entfernt wurden.

Parameter#

  • -GatewayName <string>

    • Der Name des Gateways, von dem die AnyDevice/Softphone Leitungen entfernt werden sollen

    • Dieser Parameter ist erforderlich

  • -Location <XpLocation>

    • Das Standort-Objekt, dessen AnyDevice/Softphone Leitungen entfernt werden sollen

    • Kann mit Get-XpLocations abgerufen werden

    • Erforderlich: Entweder dieser Parameter ODER ``-LocationName`` muss angegeben werden

  • -LocationName <string>

    • Der Name des Standorts als String

    • Alternative zu -Location, wenn nur der Standortname als String verfügbar ist

    • Erforderlich: Entweder dieser Parameter ODER ``-Location`` muss angegeben werden

  • -Users <XpUser[]>

    • Array von Benutzer-Objekten, deren AnyDevice/Softphone Leitungen entfernt werden sollen

    • Kann mit Get-XpUsers abgerufen werden

    • Dieser Parameter ist erforderlich

  • -Timeout <int>

    • Zeitüberschreitung in Millisekunden

    • Dieser Parameter ist optional

Eingaben#

Keine Pipeline-Eingabe unterstützt.

Ausgaben#

System.Object

Das Cmdlet gibt ein Objekt zurück, das die resultierende Benutzertabelle nach dem Entfernen enthält. Die Benutzertabelle kann über $result.Param.Users.Tables["Users"] abgerufen werden.

Beispiele#

  1. AnyDevice/Softphone Leitungen für bestimmte Benutzer entfernen:

    PS C:\Windows\system32> $users = Get-XpUsers -UserName "max.mustermann"
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn
PS C:\Windows\system32> $r = Remove-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  2. AnyDevice/Softphone Leitungen für eine AD-Gruppe entfernen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Firma_07
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn
PS C:\Windows\system32> $r = Remove-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  3. AnyDevice/Softphone Leitungen mit Standortnamen entfernen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Vertrieb
PS C:\Windows\system32> $r = Remove-XpFMCConfiguration -GatewayName OSBiz7 -LocationName "Paderborn" -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

  4. Vollständiger Workflow: Abrufen, Entfernen und Hinzufügen:

    PS C:\Windows\system32> $users = Get-XpUsersFromADGroups Firma_07
PS C:\Windows\system32> $loc = Get-XpLocations Paderborn

PS C:\Windows\system32> # Aktuelle Leitungen abrufen
PS C:\Windows\system32> $r = Get-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

PS C:\Windows\system32> # Leitungen entfernen
PS C:\Windows\system32> $r = Remove-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

PS C:\Windows\system32> # Leitungen wieder hinzufügen
PS C:\Windows\system32> $r = Add-XpFMCConfiguration -GatewayName OSBiz7 -Location $loc -Users $users
PS C:\Windows\system32> $r.Param.Users.Tables["Users"] | Format-List *

Warnung

Das Entfernen von AnyDevice/Softphone Leitungen ist eine destruktive Operation. Stellen Sie sicher, dass Sie die aktive Benutzertabelle nach dem Entfernen überprüfen, um zu bestätigen, dass die Leitungen erfolgreich entfernt wurden.

Ihre Meinung zählt!

Ob Lob, hilfreiche Ideen oder ein Hinweis auf einen Fehler - wir freuen uns über jede Nachricht.
Schreiben Sie uns einfach an doku@c4b.de und helfen Sie mit, diese Dokumentation noch besser zu machen.
Vielen Dank für Ihre Unterstützung!