Freigeben über

Get-CMSiteRole

  • Referenz
Modul:
ConfigurationManager

Ruft ein Websiterollenobjekt ab.

Syntax

Get-CMSiteRole
   [-AllSite]
   [-RoleName <String>]
   [-SiteCode <String>]
   [[-SiteSystemServerName] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSiteRole
   [-AllSite]
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Gibt die auf einem Configuration Manager-Standortsystemserver installierten Rollen zurück. Beispielsweise ein Verwaltungspunkt oder Verteilungspunkt.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen aller Rollen von allen Websites

In diesem Beispiel werden alle Rollen für alle Standorte in der Hierarchie abgerufen.

Get-CMSiteRole -AllSite

Beispiel 2: Abrufen aller Rollen für eine bestimmte Website

In diesem Beispiel werden alle Rollen vom Standort P01 abgerufen.

Get-CMSiteRole -SiteCode P01

Beispiel 3: Abrufen von Rollen für einen bestimmten Server

In diesem Beispiel werden alle Rollen abgerufen, die auf dem Standortsystem cm01.contoso.local installiert sind.

Get-CMSiteRole -SiteSystemServerName "cm01.contoso.local"

Beispiel 4: Zählen aller Verwaltungspunkte

In diesem Beispiel werden alle Verwaltungspunkte in der Hierarchie abgerufen und die Anzahl angezeigt.

$mp = Get-CMSiteRole -RoleName "SMS Management Point" -AllSite
$mp.Count

Beispiel 5: Auflisten aller Rollen nach Namen

In diesem Beispiel werden die Rollennamen für alle Standorte in der Hierarchie aufgelistet.

$allRoles = Get-CMSiteRole -AllSite
$allRoles.RoleName

Parameter

-AllSite

Schließen Sie diesen Parameter ein, um alle Rollen für die Website abzurufen.

Typ:SwitchParameter
Aliase:AllSites
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RoleName

Geben Sie einen bestimmten Rollennamen an, der abgerufen werden soll. Der Wert ist die Zeichenfolge aus der RoleName-Eigenschaft der SMS_SCI_SysResUse Klasse. Beispiel:

  • SMS Site System
  • SMS Component Server
  • SMS Distribution Point
  • SMS Management Point
  • SMS Device Management Point
  • SMS Software Update Point
  • SMS Enrollment Server
  • SMS Enrollment Web Site
  • SMS Notification Server
  • SMS Certificate Registration Point
  • SMS DM Enrollment Service
  • SMS Site Server
  • SMS State Migration Point
  • SMS Provider
  • SMS Cloud Proxy Connector
  • SMS SQL Server
  • SMS Fallback Status Point
  • AI Update Service Point
  • SMS SRS Reporting Point
  • SMS Endpoint Protection Point
  • Data Warehouse Service Point
  • SMS Dmp Connector

Hinweis

Diese Liste enthält möglicherweise nicht alle möglichen Websiterollen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-SiteCode

Geben Sie den Standortcode für die spezifische Websiterolle an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteSystemServerName

Geben Sie den Namen eines bestimmten Standortsystemservers an, von dem die Rolle abgerufen werden soll.

Typ:String
Aliase:Name, ServerName
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject