Get-SPOSite

Gibt eine oder mehrere Websitesammlungen zurück.

Syntax

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]
Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [<CommonParameters>]
Get-SPOSite
   [-Identity] <SpoSitePipeBind>
   [-DisableSharingForNonOwnersStatus]
   [<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.

Sie müssen ein SharePoint Online-Administrator oder ein globaler Administrator, sowie ein 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 werden die InformationSegments zurückgegeben, die der Website zugeordnet sind. 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 -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 9-----------------------------

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 10-----------------------------

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 11-----------------------------

$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

-Detailed

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableSharingForNonOwnersStatus

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Filter

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 verwendet werden, um zu filtern, ob es sich um die einzige Eigenschaft handelt, die im Filter vorhanden ist), LockState, URL. 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-GroupIdDefined

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

Gibt die URL der Websitesammlung an.

Type:SpoSitePipeBind
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-IncludePersonalSite

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Limit

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Template

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Eingaben

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Ausgaben

System.Object