Freigeben über

Get-SPOSite

Modul:
Microsoft.Online.SharePoint.PowerShell Module

Gibt eine oder mehrere Websitesammlungen zurück.

Syntax

ParamSet1 (Standardwert) 

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 Cmdlet-Parametersätze.

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 sie nach dem Ändern des SharePoint-Domänennamens erstellt wurden, werden mithilfe dieses Cmdlets 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 legen Sie dann die Speicherverwaltungseinstellung der Websitesammlung wieder auf die ursprüngliche Einstellung fest.

Hinweis

Wenn die Parameter Limit oder Filter angegeben werden, werden die folgenden Websitesammlungseigenschaften nicht aufgefü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

In diesem Beispiel wird das InformationSegment zurückgegeben, das der Website zugeordnet ist. Gilt für Mandanten, die die Microsoft 365 Information Barriersfunktion aktiviert haben. Informationen zu Informationsbarrieren in SharePoint Online finden Sie unter Informationen zu Informationsbarrieren .

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, für die 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 nach dem angegebenen Besitzer gefiltert werden, indem eine Variable verwendet wird.

Parameter

-ArchiveStatus

Anwendbar: SharePoint Online

Zeigt Websites eines bestimmten archivspezifischen status an. Beispiel: NotArchived, RecentlyArchived, FullyArchived, Archived oder Reactivating.

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. DisableSharingForNonOwnersStatus ist keine permanente Einstellung, sondern eine Analyse des Zustands der Websitesammlung. Dadurch wird diese Einstellung abgerufen, und es ist nicht garantiert, dass andere zurückgegebene Einstellungen korrekt sind. Um andere Einstellungen und Werte abzurufen, verwenden Sie die Get-SPOSite ohne diesen Parameter, um sicherzustellen, dass alles ordnungsgemäß 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 folgenden Eigenschaften filtern: Besitzer, Vorlage (kann zum Filtern verwendet werden, wenn dies 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, auf denen die IsAuthoritative-Eigenschaft auf true festgelegt ist. Wenn IsAuthoritative true ist, wird Microsoft Search, Copilot (BizChat) und anderen KI-Agents signalisiert, 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