Konfigurationsgruppen

Get-XpConfigGroups

Syntax

Parameter-Set String:

Get-XpConfigGroups -LocationNames <String[]> [-ConfigGroupNames <String[]>] [-Timeout <int>] [<CommonParameters>]

Parameter-Set Objekt:

Get-XpConfigGroups [-Locations] <LocationObjects[]> [-ConfigGroupNames <String[]>] [<CommonParameters>]

Beschreibung

Der Befehl Get-XpConfigGroups gibt Objekte von Konfigurationsgruppen zurück.

Ohne den Parameter -ConfigGroupNames wird nur die Standardkonfigurationsgruppe des Standorts angezeigt.

Standardmäßig werden nur Standortname, Konfigurationsgruppenname und die Beschreibung der Konfigurationsgruppe ausgegeben. Mithilfe des Befehls Select-Object können jedoch alle verfügbaren Eigenschaften der Konfigurationsgruppen angezeigt werden (siehe Beispiele).

Parameter

• -LocationNames <String[]>

  • Entspricht einer Ausführung von:

    >Get-XpLocations -LocationNames <String[]> | Get-XpConfigGroups -LocationObjects <CFGBranch[]>
    

  • Wird meist über die Pipeline übergeben und entspricht dem Ergebnis von:

    >Get-XpLocations
    

• -ConfigGroupNames <String[]>

  • Optional kann eine Liste von Namen der Konfigurationsgruppen (durch Komma getrennt) angegeben werden.

  • Wird dieser Parameter nicht angegeben, so wird nur die Standardkonfigurationsgruppe der entsprechenden Standorte zurückgegeben.

  • Mit dem Wildcard Symbol * werden alle Konfigurationsgruppen eines Standortes zurückgegeben.

• -Timeout <int>

  • Zeitüberschreitung in Minuten.

  • Wenn ein Kommando (z.B. aufgrund zu vieler Datensätze o.ä.) zu lange benötigt, kann dieses Kommando mit diesem Parameter nach der angegebenen Zeit abgebrochen werden.

• <CommonParameters>

  • Beschreibt die Parameter, die mit jedem Cmdlet verwendet werden können. Siehe Microsoft Dokumentation.

Eingaben

Der Eingabetyp ist der Typ der Objekte, die per Pipelining an Get-XpConfigGroups übergeben werden können:

• CFGBranch

Ausgaben

Der Befehl Get-XpConfigGroups gibt Objekte vom Typ CFGConfigGroup zurück.

CFGConfigGroup
Property	Supported values
BranchName	String
GuidAnnouncement
GuidClient
GuidCollaboration
GuidContactList
GuidFax
GuidInstantMessaging
GuidLanguage
GuidMobileControl
GuidPasswordComplexity
GuidPresence
GuidSms
GuidTelephony
GuidTemplateContainer
GuidVoicemail
IsDefault	Boolean
Description	String
FunctionAnnouncement	ConfigGroupInherit | ConfigGroupIndividual
FunctionClient	ConfigGroupInherit | ConfigGroupIndividual
FunctionCollaboration	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
FunctionContactList	ConfigGroupInherit | ConfigGroupIndividual
FunctionFax	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
FunctionInstantMessaging	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
FunctionLanguage	ConfigGroupInherit | ConfigGroupIndividual
FunctionMailbox
FunctionMobileControl
FunctionPasswordComplexity	ConfigGroupInherit | ConfigGroupIndividual
FunctionPresence	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
FunctionSms	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
FunctionTelephony	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
FunctionVoicemail	ConfigGroupInherit | ConfigGroupIndividual | ConfigGroupInactive
Id
Name	String
ExtensionData
UtcOffset

Beispiel

1. Ausgabe der Standardkonfigurationsgruppe des Standortes Hauptstandort

   >Get-XpLocations Hauptstandort | Get-XpConfigGroups
   

2. Ausgabe aller Konfigurationsgruppen des Standortes Hauptstandort:

   >Get-XpLocations Hauptstandort | Get-XpConfigGroups -ConfigGroupNames *
   

   • Beachten Sie, dass in diesem Fall der Parameter -ConfigGroupNames explizit benannt werden muss.

   • >Get-XpLocations Hauptstandort | Get-XpConfigGroups * würde zu einer Fehlermeldung führen!

3. Ausgabe der Konfigurationsgruppen KGruppe1 und KGruppe2 der Standorte Hauptstandort und Nebenstandort

   >Get-XpLocations Hauptstandort,Nebenstandort | Get-XpConfigGroups -ConfigGroupNames KGruppe1,KGruppe2
   

Set-XpConfigGroups

Syntax

Set-XpConfigGroups -ConfigGroups <CFGConfigGroup[]> [-Timeout <int>]

Beschreibung

Set-XpConfigGroups speichert die übergebenen CFGConfigGroup Objekte aus Get-XpConfigGroups im XPhone Connect Server.

Alle Änderungen am Objekt werden sofort und ohne Rückfrage an den XPhone Connect Server übertragen und dort gespeichert.

Warnung

Die Änderungen sind anschließend nicht mehr rückgängig zu machen, eine gründliche Überprüfung der geänderten Daten ist deshalb unumgänglich.

Parameter

• ConfigGroups <CFGConfigGroup[]>

  • Spezifiziert die im XPhone Connect Server zu speichernden Konfigurationsgruppen-Objekte.

  • Diese Objekte werden normalerweise über die Pipeline übergeben.

• -Timeout <int>

  • Zeitüberschreitung in Minuten.

  • Wenn ein Kommando (z.B. aufgrund zu vieler Datensätze o.ä.) zu lange benötigt, kann dieses Kommando mit diesem Parameter nach der angegebenen Zeit abgebrochen werden.

Eingaben

Der Eingabetyp ist der Typ der Objekte, die per Pipelining an Set-XpConfigGroups übergeben werden können:

• CFGConfigGroup

Ausgaben

Der Befehl Set-XpConfigGroups gibt keine Objekte zurück.

Beispiel

Umstellung des Client-Templates aller Konfigurationsgruppen mit dem Namen Konfigurationsgruppe1 von Erbt von Standort zu Individuell:

> Get-XpLocations | Get-XpConfigGroups -ConfigGroupNames Konfigurationsgruppe1 | foreach{$_.FunctionClient = "ConfigGroupIndividual";$_} | Set-XpConfigGroups

Haben Sie einen Fehler auf dieser Seite gefunden?

Oder ist etwas nicht gut oder zu ungenau formuliert? Dann freuen wir uns über eine E-Mail, am besten mit einem Verbesserungsvorschlag, an doku@c4b.de. Vielen Dank!