Freigeben über

  • Artikel

Get-CsArchivingPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu Archivierungsrichtlinien für Sofortnachrichtensitzungen (Instant Messaging) zurück. Mit Archivierungsrichtlinien können Sie alle Sofortnachrichten- und Webkonferenzsitzungen archivieren, die zwischen internen Benutzern und/oder zwischen internen und externen Benutzern stattfinden.

Syntax

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

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

Detaillierte Beschreibung

Viele Organisationen erachten es als sinnvoll, ein Archiv aller Sofortnachrichtensitzungen anzulegen, an denen die Benutzer teilnehmen. Andere Organisationen sind gesetzlich verpflichtet, ein solches Archiv zu erstellen. Für das Archivieren von Sofortnachrichtensitzungen mit Microsoft Lync Server 2010 müssen zwei Schritte ausgeführt werden. Zunächst muss die Archivierung mit dem Cmdlet Set-CsArchivingConfiguration auf globaler Ebene und/oder Standortebene aktiviert werden. Dies ermöglicht Ihnen zwar das Archivieren von Sofortnachrichtensitzungen, startet jedoch nicht automatisch die Archivierung dieser Sitzungen.

Um tatsächlich Aufzeichnungen der Sofortnachrichtensitzungen zu speichern, müssen Sie noch den zweiten Schritt ausführen: Es müssen eine oder mehrere Archivierungsrichtlinien für Sofortnachrichtensitzungen erstellt werden. Diese Richtlinien bestimmen, für welche Benutzer die Sofortnachrichtensitzungen aufgezeichnet werden und welche Form von Sofortnachrichtensitzungen (intern und/oder extern) archiviert wird. Bei internen Sofortnachrichtensitzungen sind alle Teilnehmer authentifizierte Benutzer mit einem Active Directory-Konto in Ihrer Organisation; bei externen Sofortnachrichtensitzungen ist mindestens ein Teilnehmer ein nicht authentifizierter Benutzer, der über kein Active Directory-Konto in Ihrer Organisation verfügt. Sie können wahlweise nur interne Sitzungen, nur externe Sitzungen oder sowohl interne als auch externe Sitzungen archivieren.

Archivierungsrichtlinien (die mit dem Cmdlet New-CsArchivingPolicy erstellt werden) können global oder auf Standortebene zugewiesen werden. Darüber hinaus können diese Richtlinien auf Benutzerbasis zugewiesen werden, d. h., eine Richtlinie kann erstellt und dann einem bestimmten Benutzer oder einer bestimmten Benutzergruppe zugewiesen werden. So können Sie beispielsweise über eine globale Richtlinie verfügen, mit der die internen Sofortnachrichtensitzungen aller Benutzer archiviert werden. Zusätzlich können Sie eine zweite Richtlinie erstellen, mit der sowohl interne als auch externe Sitzungen archiviert werden. Diese zweite Richtlinie wird dann nur auf die Vertriebsmitarbeiter angewendet. Da benutzerbasierte Richtlinien Vorrang vor den global und auf Standortebene zugewiesenen Richtlinien haben, werden sämtliche Sofortnachrichtensitzungen der Vertriebsmitarbeiter archiviert. Für andere Benutzer (Benutzer, die nicht Mitglied der Vertriebsabteilung sind und damit nicht von den Vertriebsrichtlinien betroffen sind) werden nur interne Sofortnachrichtensitzungen archiviert.

Das Cmdlet Get-CsArchivingPolicy bietet Ihnen die Möglichkeit, Informationen zu allen für die Verwendung in Ihrer Organisation konfigurierten Archivierungsrichtlinien zurückzugeben. Beachten Sie, dass diese Richtlinien nur greifen, wenn die Archivierungsfunktion für Sofortnachrichtensitzungen global oder auf Standortebene aktiviert wurde. Verwenden Sie das Cmdlet Get-CsArchivingConfiguration, um zu ermitteln, ob die Archivierung für Sofortnachrichtensitzungen aktiviert wurde.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsArchivingPolicy 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-CsArchivingPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zurückzugebende Archivierungsrichtlinie. Verwenden Sie diese Syntax, um auf die globale Richtlinie zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Standortrichtlinie zu verweisen: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um auf eine benutzerbasierte Richtlinie zu verweisen: -Identity RedmondArchivingPolicy. Wenn dieser Parameter ausgelassen wird, werden alle Archivierungsrichtlinien zurückgegeben, die für die Verwendung in Ihrer Organisation konfiguriert sind.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Richtlinie(n). Verwenden Sie beispielsweise diese Syntax, um alle auf Standortebene konfigurierten Richtlinien zurückzugeben. -Filter "site:*". Auf diese Weise werden alle Richtlinien zurückgegeben, bei denen der Wert für "Identity" (dies ist die einzige Eigenschaft, nach der gefiltert werden kann) mit dem Zeichenfolgenwert "site:" beginnt. Verwenden Sie diese Syntax, um eine Auflistung aller benutzerbasierten Richtlinien zurückzugeben, deren Identitätswert mit "Sales" beginnt. -Filter "Sales*".

LocalStore

Optional

Switch-Parameter

Ruft die Daten zu Archivierungsrichtlinien aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsArchivingPolicy akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsArchivingPolicy werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy" zurückgegeben.

Beispiel

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

Get-CsArchivingPolicy

In Beispiel 1 wird Get-CsArchivingPolicy ohne Parameter aufgerufen. Auf diese Weise wird eine Auflistung aller derzeit in der Organisation verwendeten Archivierungsrichtlinien zurückgegeben.

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

Get-CsArchivingPolicy -Identity site:Redmond

In Beispiel 2 wird mit Get-CsArchivingPolicy die Archivierungsrichtlinie mit dem Identitätswert "site:Redmond" zurückgegeben. Da Identitätswerte eindeutig sein müssen, wird mit diesem Befehl immer nur maximal eine Richtlinie zurückgegeben.

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

Get-CsArchivingPolicy -Filter tag:*

Mit dem vorstehenden Befehl wird eine Auflistung aller Archivierungsrichtlinien zurückgegeben, die auf Benutzerbasis konfiguriert wurden. Hierzu werden der Parameter "Filter" und der Filterwert "tag:*" verwendet. Der Filterwert weist Get-CsArchivingPolicy an, nur die Richtlinien zurückzugeben, deren Identitätswert mit "tag:*" beginnt.

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

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False}

In Beispiel 4 wird eine Auflistung aller Archivierungsrichtlinien zurückgegeben, bei denen die Archivierung von internen Sofortnachrichtensitzungen deaktiviert ist. Hierzu gibt Get-CsArchivingPolicy zunächst eine Auflistung aller derzeit verwendeten Archivierungsrichtlinien zurück. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet. Where-Object wendet einen Filter an, mit dem die zurückgegebenen Daten auf die Richtlinien beschränkt werden, bei denen die Eigenschaft "ArchiveInternal" auf "False" festgelegt wurde.

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

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False -and $_.ArchiveExternal -eq $False}

Beispiel 5 ähnelt Beispiel 4; in diesem Fall gibt der Befehl jedoch alle Archivierungsrichtlinien zurück, bei denen sowohl die Archivierung von internen als auch von externen Sitzungen deaktiviert wurde. Hierzu wird mit Get-CsArchivingPolicy zunächst eine Auflistung aller derzeit verwendeten Archivierungsrichtlinien zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Richtlinien herausfiltert, bei denen sowohl "ArchiveInternal" als auch "ArchiveExternal" den Wert "False" aufweisen. Der Operator "-and" weist Where-Object an, nur die Richtlinien herauszufiltern, die alle angegebenen Kriterien erfüllen. Zur Auswahl von Richtlinien, die lediglich eines (oder beide) der angegeben Kriterien erfüllen, verwenden Sie den Operator "-or":

Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}