Set-CsExUmContact
Letztes Änderungsdatum des Themas: 2012-03-25
Ändert eine vorhandene automatische Telefonzentrale oder ein Kontaktobjekt für den Teilnehmerzugriff für den gehosteten Exchange Unified Messaging (UM)-Dienst.
Syntax
Set-CsExUmContact -Identity <UserIdParameter> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Microsoft Lync Server 2010 wird mit Exchange UM eingesetzt, um verschiedene VoIP-bezogene Funktionen wie automatische Telefonzentralen oder den Teilnehmerzugriff bereitzustellen. Wenn Exchange UM nicht als lokaler, sondern als gehosteter Dienst bereitgestellt wird, müssen zum Verwenden einer automatischen Telefonzentrale und des Teilnehmerzugriffs Kontaktobjekte mit Windows PowerShell erstellt werden. Diese Objekte werden durch Aufruf des Cmdlets New-CsExUmContact erstellt und können später mithilfe des Cmdlets Set-CsExUmContact geändert werden.
Die einfachste Methode zur Verwendung dieses Cmdlets besteht darin, zunächst mit Get-CsExUmContact eine Instanz des Kontaktobjekts abzurufen, das Sie ändern möchten. Leiten Sie die Ausgabe des Befehls Get-CsExUmContact an das Cmdlet Set-CsExUmContact weiter, und weisen Sie Parameterwerte für die Eigenschaften zu, die Sie ändern möchten. (Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema.) Alternativ können Sie das Cmdlet Set-CsExUmContact aufrufen und ihm die Identität des Kontaktobjekts übergeben, das geändert werden soll.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsExUmContact lokal auszuführen: RTCUniversalUserAdmins. 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 "Set-CsExUmContact"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserIdParameter |
Die eindeutige ID für das Kontaktobjekt, das geändert werden soll. Kontaktidentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Kontakts, 2) Benutzerprinzipalname (User Principal Name, UPN) des Kontakts, 3) Domänen- und Anmeldename des Kontakts (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\exum1") und 4) Active Directory-Anzeigename des Kontakts (z. B. "Team Auto Attendant"). Vollständiger Datentyp: Microsoft.Rtc.Management.AD.UserIdParameter |
AutoAttendant |
Optional |
Boolescher Wert |
Legen Sie den Parameter auf "True" fest, wenn es sich bei dem Kontaktobjekt um eine automatische Telefonzentrale handelt. Dieser Parameter ist standardmäßig auf "False" festgelegt. |
Description |
Optional |
Zeichenfolge |
Eine Beschreibung dieses Kontakts. Anhand der Beschreibung können Administratoren den Typ des Kontakts (automatische Telefonzentrale oder Teilnehmerzugriff), den Standort, den Anbieter sowie andere Informationen ermitteln, die Aufschluss über den Zweck der einzelnen Exchange UM-Kontakte geben. |
DisplayNumber |
Optional |
Zeichenfolge |
Die Telefonnummer des Kontakts. Die Anzeigenummern für jeden Kontakt müssen eindeutig sein. (Es ist nicht zulässig, dass zwei Exchange UM-Kontakte über dieselbe Anzeigenummer verfügen.) Eine Änderung dieses Werts führt auch zu einer Änderung der Eigenschaft "LineURI". Dieser Wert kann mit einem Pluszeichen (+) beginnen und eine beliebige Anzahl von Ziffern umfassen. Die erste Ziffer darf keine Null sein. |
Enabled |
Optional |
Boolescher Wert |
Gibt an, ob der Kontakt für Lync Server 2010 aktiviert ist. Durch das Festlegen dieses Parameters auf "False" wird der Kontakt deaktiviert, wodurch die diesem Kontakt zugeordnete automatische Telefonzentrale bzw. der Teilnehmerzugriff nicht mehr funktioniert. Wenn Sie ein Konto über den Parameter "Enabled" deaktivieren, werden die diesem Konto zugeordneten Informationen (einschließlich der zugewiesenen gehosteten Voicemailrichtlinien) beibehalten. Wird das Konto zu einem späteren Zeitpunkt über den Parameter "Enable" erneut aktiviert, werden die zugeordneten Kontoinformationen wiederhergestellt. |
EnterpriseVoiceEnabled |
Optional |
Boolescher Wert |
Gibt an, ob der Kontakt für Enterprise-VoIP aktiviert ist. Ist dieser Wert auf "False" gesetzt, stehen die Funktionen für die automatische Telefonzentrale und der Teilnehmerzugriff für diesen Kontakt nicht länger zur Verfügung. |
SipAddress |
Optional |
Zeichenfolge |
Die SIP-Adresse des Kontakts. Dabei muss es sich um eine neue Adresse handeln, die noch nicht als Benutzer oder Kontakt in Active Directory-Domänendienste (AD DS) vorhanden ist. Eine Änderung dieses Werts wirkt sich auch auf die in der Eigenschaft "OtherIpPhone" gespeicherte SIP-Adresse aus. Die SIP-Adresse kann im Cmdlet Get-CsExUmContact als Identitätswert verwendet werden, um spezifische Kontakte abzurufen. Wenn Sie dieses Cmdlet aufrufen, wird die neue SIP-Adresse verwendet; Abfragen unter Verwendung der alten SIP-Adresse geben kein Objekt zurück. |
DomainController |
Optional |
FQDN |
Ermöglicht die Angabe eines Domänencontrollers. Wenn kein Domänencontroller angegeben ist, wird der erste verfügbare Domänencontroller verwendet. |
PassThru |
Optional |
Switch-Parameter |
Gibt die Ergebnisse des Befehls zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact-Objekt. Akzeptiert eine weitergeleitete Eingabe von Exchange UM-Kontaktobjekten.
Rückgabetypen
Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact" geändert. Bei Verwendung mit dem Parameter "PassThru" wird auch ein Objekt dieses Typs zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsExUmContact -Identity sip:exumsa4@fabrikam.com | Set-CsExUmContact -AutoAttendant $True
In diesem Beispiel wird die Eigenschaft "AutoAttendant" des Exchange UM-Kontakts mit der SIP-Adresse "exumsa4@fabrikam.com" auf "True" festgelegt. Zunächst wird das Cmdlet Get-CsExUmContact aufgerufen, um das Kontaktobjekt abzurufen. (Alternativ kann auch der Active Directory-Anzeigename, der Benutzerprinzipalname (User Principal Name, UPN) oder der Anmeldename des Kontakts verwendet werden.) Dieser Befehl ruft den einen Kontakt mit der angegebenen Identität ab. Dieser Kontakt wird anschließend an das Cmdlet Set-CsExUmContact übergeben, und der Parameter "AutoAttendant" wird auf "True" festgelegt.
-------------------------- Beispiel 2 --------------------------
Set-CsExUmContact -Identity "CN={1bf6208d-2847-45d0-828f-636f14da858b},OU=ExUmContacts,DC=litwareinc,DC=com" -AutoAttendant $True
Dieses Beispiel ist mit Beispiel 1 identisch, der Kontakt wird jedoch nicht über einen Aufruf von Get-CsExUmContact und Übergabe des Objekts an Set-CsExUmContact abgerufen. Stattdessen wird an Set-CsExUmContact die Identität des Kontakts übergeben, der geändert werden soll. Beachten Sie das Format für den Identitätswert: Es muss sich in diesen Fall um den vollständigen Distinguished Name (DN) des Kontaktobjekts handeln, der eine automatisch generierte GUID enthält. (Diese wird bei der Erstellung des Kontakts generiert.) Anschließend wird der Parameter "AutoAttendant" des Kontakts auf "True" festgelegt.
Siehe auch
Weitere Ressourcen
New-CsExUmContact
Remove-CsExUmContact
Get-CsExUmContact
Move-CsExUmContact