Get-CsUCPhoneConfiguration

Syntax

Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUCPhoneConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

In Lync 2010 Phone Edition werden die Funktionen von Telefon und Microsoft Lync 2010 zusammengeführt. Lync 2010 Phone Edition nutzt ein spezielles Gerät (d. h. ein mit Lync 2010 kompatibles Telefon), das als VoIP-Telefon verwendet werden kann. Darüber hinaus kann diese Hardware auch als Lync 2010-ähnlicher Endpunkt genutzt werden: Sie können den aktuellen Status festlegen, den Status Ihrer Lync 2010-Kontakte überprüfen, nach neuen Kontakten suchen und viele andere Aktivitäten ausführen, die Sie von Lync 2010 kennen.

Mit den CsUCPhoneConfiguration-Cmdlets können Sie Ihre Lync 2010-Telefone verwalten. Sie können z. B. die Mindestlänge der zur Anmeldung am Telefon erforderlichen persönlichen Identifikationsnummer (PIN) festlegen und bestimmen, ob das Telefon nach einem bestimmten Zeitraum der Inaktivität automatisch gesperrt wird.

Konfigurationseinstellungen für das Telefon können entweder global oder auf Standortebene angewendet werden. (Auf Standortebene zugewiesene Einstellungen haben Vorrang vor den global zugewiesenen Einstellungen.) Mit dem Cmdlet Get-CsUCPhoneConfiguration können Sie Informationen zu den derzeit in Ihrer Organisation verwendeten Telefonkonfigurationseinstellungen abrufen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsUCPhoneConfiguration lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUCPhoneConfiguration"}

Parameter

Eingabetypen

Keine. Get-CsUCPhoneConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsUCPhoneConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings" zurückgegeben.

Beispiel

-------------------------- Beispiel 1 --------------------------

Get-CsUCPhoneConfiguration

Der Befehl in Beispiel 1 gibt alle derzeit in der Organisation verwendeten UC-Telefonkonfigurationseinstellungen zurück. Beim Aufrufen von Get-CsUCPhoneConfiguration ohne zusätzliche Parameter wird immer eine vollständige Auflistung der Telefonkonfigurationseinstellungen zurückgegeben.

-------------------------- Beispiel 2 --------------------------

Get-CsUCPhoneConfiguration -Identity site:Redmond

In Beispiel 2 werden nur die UC-Telefonkonfigurationseinstellungen mit dem Identitätswert "site:Redmond" zurückgegeben. Da Identitätswerte eindeutig sein müssen, gibt dieser Befehl immer nur eine Auflistung von Telefonkonfigurationseinstellungen zurück.

-------------------------- Beispiel 3 --------------------------

Get-CsUCPhoneConfiguration -Filter site:*

Im vorstehenden Beispiel werden alle UC-Telefoneinstellungen zurückgegeben, die auf Standortebene konfiguriert wurden. Hierzu wird Get-CsUCPhoneConfiguration zusammen mit dem Parameter "Filter" aufgerufen. Der Filterwert "site:*" beschränkt die zurückgegebenen Daten auf Einstellungen, deren Identitätseigenschaft (die einzige Eigenschaft, nach der gefiltert werden kann) mit dem Zeichenfolgenwert "site:" beginnt. Laut Definition handelt es sich bei allen Einstellungen, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt, um Einstellungen, die auf Standortebene konfiguriert wurden.

-------------------------- Beispiel 4 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}

In Beispiel 4 werden die UC-Telefonkonfigurationseinstellungen zurückgegeben, deren SIP-Sicherheitsmodus auf "Medium" eingestellt ist. (Die SIP-Sicherheit kann auf "Low", "Medium" oder "High" eingestellt werden.) Hierzu verwendet der Befehl zunächst Get-CsUCPhoneConfiguration ohne zusätzliche Parameter, um eine Auflistung aller UC-Telefoneinstellungen zurückzugeben, die derzeit zur Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "SIPSecurityMode" den Wert "Medium" aufweist.

-------------------------- Beispiel 5 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}

In Beispiel 5 werden UC-Telefoneinstellungen zurückgegeben, die eines oder beide der folgenden Kriterien erfüllen: 1) die Telefonsperre wird nicht erzwungen, und/oder 2) die Mindestlänge der PIN beträgt weniger als 6 Ziffern. Hierzu gibt der Befehl zunächst durch den Aufruf von Get-CsUCPhoneConfiguration eine Auflistung aller derzeit in der Organisation verwendeten UC-Telefoneinstellungen zurück. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das die Elemente auswählt, die eines (oder beide) der folgenden Kriterien erfüllen. 1) Die Eigenschaft "EnforcePhoneLock" weist den Wert "False" auf, und/oder 2) die Eigenschaft "MinPhoneLength" beträgt weniger als 6.

Der Vergleichsoperator "-or" weist Where-Object an, Einstellungen herauszufiltern, die eines (oder beide) der Kriterien erfüllen. Verwenden Sie den Vergleichsoperator "-and", um Einstellungen herauszufiltern, die beide Kriterien erfüllen. (In diesem Fall bedeutet dies, dass die Telefonsperre nicht erzwungen wird und die PIN-Länge weniger als 6 beträgt.)

Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}

Siehe auch

Weitere Ressourcen

New-CsUCPhoneConfiguration
Remove-CsUCPhoneConfiguration
Set-CsUCPhoneConfiguration