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

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet Parameter Sets.

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:

Additional site collections are now displayed. For example, all group and video sites along with team sites will be displayed.

The Detailed parameter has been deprecated. It will continue to work with earlier versions

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

If Site Collection Storage Management is enabled for the tenant, you will not be able to set quota and will have a generic error returned. To workaround this issue, set the site collection storage management to "manual" temporarily, set your quotas and then set the site collection storage management setting back to its original setting.

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. Weitere Informationen zu Informationsbarrieren zum Verständnis von Informationsbarrieren in SharePoint Online.

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.

-----------------------EXAMPLE 11-----------------------------

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

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

Parameter

-Detailliert

Use this parameter to get additional property information on a site collection. You will notice a slower response time when the Detailed parameter is used.

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
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 Management Shell Version 16.0.4613.1211 oder höher verfügbar.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Grenze

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
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, $false und nicht definiert. Standardmäßig ist der Wert nicht definiert, was bedeutet, dass der Filter nicht angewendet wird.

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

-Identität

Gibt die URL der Websitesammlung an.

Type:SpoSitePipeBind
Position:0
Default value:None
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.

The values are $true and $false. By default, the value is $false which means no personal sites will be returned.

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

-Vorlage

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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Eingaben

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Ausgaben

System.Object