Get-SPOSite

Modul:
Microsoft.Online.SharePoint.PowerShell Module

Gibt eine oder mehrere Websitesammlungen zurück.

Syntax

ParamSet1 (Standard) 

Get-SPOSite
    [[-Identity] <SpoSitePipeBind>]
    [-Limit <String>]
    [-Detailed]
    [-IsAuthoritative <Boolean>]
    [<CommonParameters>]

ParamSet3 

Get-SPOSite
    [-Identity] <SpoSitePipeBind>
    [-DisableSharingForNonOwnersStatus]
    [<CommonParameters>]

ParamSet2 

Get-SPOSite
    [-Filter <String>]
    [-Limit <String>]
    [-Detailed]
    [-Template <String>]
    [-IncludePersonalSite <Boolean>]
    [-GroupIdDefined <Boolean>]
    [-ArchiveStatus <ArchiveStatusFilterType>]
    [<CommonParameters>]

Beschreibung

Dieses Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

Mit dem Get-SPOSite-Cmdlet werden die Eigenschaften aller Websitesammlungen abgerufen und zurückgegeben, die die angegebenen Kriterien erfüllen.

Bei Verwendung der Version 5361 der SharePoint Online Management Shell, beobachten Sie möglicherweise Folgendes:

Es werden nun zusätzliche Websitesammlungen angezeigt. Beispielsweise werden neben Teamwebsites alle Gruppen- und Videowebsites angezeigt.

Der Detailed-Parameter wird nicht mehr unterstützt. In älteren Versionen funktioniert dieser weiterhin.

Hinweis

Websitesammlungen im Papierkorb werden mit dem Get-SPOSite-Cmdlet nicht abgerufen.

Websiteumleitungen, wie diejenigen, die nach der Änderung des SharePoint-Domänennamens erstellt werden, werden mit diesem Cmdlet abgerufen.

Sie müssen ein SharePoint Online-Administrator und Websitesammlungsadministrator sein, um das Cmdlet ausführen zu können.

Angaben zu Berechtigungen sowie die aktuellsten Informationen zu Windows PowerShell für SharePoint Online finden Sie in der Onlinedokumentation unter Einführung in die SharePoint Online-Verwaltungsshell.

Hinweis

Wenn für den Mandanten die Speicherverwaltung der Websitesammlung aktiviert ist, können Sie kein Kontingent festlegen, und es wird ein allgemeiner Fehler zurückgegeben. Um dieses Problem zu umgehen, legen Sie die Speicherverwaltung der Websitesammlung vorübergehend auf "manuell" fest, legen Sie Ihre Kontingente fest, und setzen Sie dann die Einstellung für die Speicherverwaltung der Websitesammlung wieder auf die ursprüngliche Einstellung zurück.

Hinweis

Wenn die Parameter "Limit" oder "Filter" angegeben werden, werden die folgenden Websitesammlungseigenschaften nicht ausgefüllt und enthalten möglicherweise einen Standardwert: AllowDownloadingNonWebViewableFiles, AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

Beispiele

BEISPIEL 1

Get-SPOSite

In Beispiel 1 werden alle Websitesammlungen zurückgegeben.

BEISPIEL 2

Get-SPOSite -Identity https://contoso.sharepoint.com

In Beispiel 2 wird eine bestimmte Websitesammlung mit Detailangaben zu den Eigenschaften aufgelistet.

BEISPIEL 3

Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatus

Beispiel 3 aktualisiert den Status, ob die Nicht-Besitzer einer Websitesammlung die Websitesammlung freigeben können (dieser Wert wird nicht festgelegt).

BEISPIEL 4

Get-SPOSite -Template GROUP#0 -IncludePersonalSite:$false

In diesem Beispiel werden Gruppenwebsitesammlungen in einem Mandanten aufgelistet.

BEISPIEL 5

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |fl

In diesem Beispiel werden Kontingentdetails für eine Gruppenwebsite abgerufen.

BEISPIEL 6

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment

Dieses Beispiel gibt das mit der Website verknüpfte InformationSegment zurück. Gilt für Mandanten, die die Microsoft 365 Information Barriersfunktion aktiviert haben. Lesen Sie Erfahren Sie mehr über Informationsbarrieren , um Informationsbarrieren in SharePoint Online zu verstehen.

Hinweis: Diese Eigenschaft ist nur in SharePoint Online-Verwaltungsshell Version 16.0.19927.12000 oder höher verfügbar.

BEISPIEL 7

Get-SPOSite -Filter { Url -like "contoso.sharepoint.com/sites/18" }

In diesem Beispiel wird die serverseitige Filterung verwendet, um Websites zurückzugeben, die 18 entsprechen.

BEISPIEL 8

Get-SPOSite -Filter { IsAuthoritative -eq true }

In diesem Beispiel wird die serverseitige Filterung verwendet, um autorisierende Websites zurückzugeben (d. h. Websites, bei denen die IsAuthoritative-Eigenschaft auf true festgelegt ist).

BEISPIEL 9

Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

In diesem Beispiel wird die clientseitige Filterung verwendet, um eine Liste von Websites zurückzugeben, die mit Microsoft Teams verbunden sind.

BEISPIEL 10

Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}

In diesem Beispiel wird die clientseitige Filterung verwendet, um eine Liste von Websites zurückzugeben, die mit einem privaten Microsoft Teams Kanal oder einem freigegebenen Kanal verbunden sind.

BEISPIEL 11

Get-SPOSite -Limit ALL -GroupIdDefined $true

In diesem Beispiel wird die serverseitige Filterung verwendet, um alle Websites zurückzugeben, denen eine Microsoft 365-Gruppe zugeordnet ist.

BEISPIEL 12

$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"

In diesem Beispiel werden alle Websites abgerufen, die mithilfe einer Variablen nach dem angegebenen Besitzer gefiltert wurden.

Parameter

-ArchiveStatus

Anwendbar: SharePoint Online

Zeigt Websites mit einem bestimmten Archiv-Status an. Beispielsweise "Nicht archiviert", "Zuletzt archiviert", "Vollständig archiviert", "Archiviert" oder "Wird reaktiviert".

Parametereigenschaften

Typ:Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType
Standardwert:None
Zulässige Werte:NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Detailed

Anwendbar: SharePoint Online

Verwenden Sie diesen Parameter, um Angaben zu zusätzlichen Eigenschaften einer Websitesammlung abzurufen. Sie werden feststellen, dass die Reaktionszeit länger ist, wenn Sie den Detailed-Parameter verwenden.

Die folgenden Eigenschaften werden zurückgegeben:

  • ResourceUsageCurrent
  • ResourceUsageAverage
  • StorageUsageCurrent
  • LockIssue
  • WebsCount
  • CompatibilityLevel
  • AllowSelfServiceUpgrade
  • SiteDefinedSharingCapability

Gibt den gespeicherten Wert der Websiterichtlinie zurück.

  • SharingCapability

Gibt die effektive Zugriffsebene zurück, bei der es sich um die Websiterichtlinie und die Mandantenrichtlinie handelt.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet1
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableSharingForNonOwnersStatus

Anwendbar: SharePoint Online

Dieser Parameter verhindert die Freigabe durch Benutzer, die nicht der Besitzer sind.

Hinweis

Dieser Parameter ist nur in der SharePoint Online-Verwaltungsshell-Version 16.0.4613.1211 oder höher verfügbar. Bei "DisableSharingForNonOwnersStatus" handelt es sich nicht um eine persistente Einstellung, sondern um eine Analyse des Zustands der Websitesammlung. Der Zweck besteht darin, diese Einstellung abzurufen, und es ist nicht garantiert, dass andere zurückgegebene Einstellungen korrekt sind. Verwenden Sie die Get-SPOSite ohne diesen Parameter, um andere Einstellungen und Werte abzurufen, um sicherzustellen, dass alles korrekt angezeigt wird.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet3
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

Anwendbar: SharePoint Online

Gibt den Skriptblock des anzuwendenden serverseitigen Filters an. Der Typ muss ein gültiger Filtername sein und der Wert muss das Format { PropertyName <operator> "filterValue"}aufweisen. Gültige Operatoren sind: -eq, -ne, -like, -notlike. Derzeit können Sie nach diesen Eigenschaften filtern: Besitzer, Vorlage (kann zum Filtern verwendet werden, wenn es die einzige Eigenschaft im Filter ist), LockState, URL, IsAuthoritative (unterstützt nur Vergleichsoperatoren -eq und -ne). Die Verwendung des -Or-Operators zum Einschließen eines zusätzlichen Filters wird nicht unterstützt.

Hinweis: Bei den Operatorwerten wird die Groß- und Kleinschreibung beachtet.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GroupIdDefined

Anwendbar: SharePoint Online

Filtert die Liste der Websites, die an Websites mit einer Gruppen-ID zurückgegeben werden (z. B. Websites, die mit einer Microsoft 365-Gruppe verbunden sind), wenn der Wert auf $true festgelegt ist. Begrenzt die Liste der Websites auf Websites ohne Gruppen-ID, wenn der Wert $false ist.

Die Werte sind $true, $falseund nicht definiert. Standardmäßig ist der Wert nichtdefiniert, was bedeutet, dass der Filter nicht angewendet wird.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Anwendbar: SharePoint Online

Gibt die URL der Websitesammlung an.

Parametereigenschaften

Typ:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet1
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ParamSet3
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludePersonalSite

Anwendbar: SharePoint Online

Zeigt persönliche Websites an, wenn der Wert auf „$true“ festgelegt ist.

Die Werte sind „$true“ oder „$false“. Standardmäßig lautet der Wert „$false“, was bedeutet, dass keine persönlichen Websites zurückgegeben werden.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsAuthoritative

Anwendbar: SharePoint Online

Filtern Sie die Liste der Websites, an denen die IsAuthoritative-Eigenschaft auf "true" festgelegt ist. Wenn IsAuthoritative "true" ist, signalisiert dies Microsoft Search, Copilot (BizChat) und anderen KI-Agents, dass der Inhalt der Website offiziell, vertrauenswürdig und verifiziert ist.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet1
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Limit

Anwendbar: SharePoint Online

Gibt die maximale Anzahl der Websitesammlungen an, die zurückgegeben werden soll. Dies kann eine beliebige Zahl sein. Wenn alle Websitesammlungen abgerufen werden sollen, verwenden Sie ALL. Der Standardwert lautet 200. Wenn dieser Parameter angegeben wird, werden einige Websitesammlungseigenschaften nicht aufgefüllt und enthalten möglicherweise einen Standardwert.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet1
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Template

Anwendbar: SharePoint Online

Zeigt Websites einer bestimmten Vorlage an. Zum Beispiel: STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 oder SITEPAGEPUBLISHING#0.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ParamSet2
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Ausgaben

System.Object