Delen via

Get-CMSiteRole

  • Artikel

SYNOPSIS

Haal een siterolobject op.

SYNTAX

SearchByName (standaard)

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

SearchByValue

Get-CMSiteRole [-AllSite] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

Retourneert de rollen die zijn geïnstalleerd op Configuration Manager sitesysteemserver. Bijvoorbeeld een beheerpunt of distributiepunt.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Alle rollen van alle sites op halen

In dit voorbeeld worden alle rollen voor alle sites in de hiërarchie gebruikt.

Get-CMSiteRole -AllSite

Voorbeeld 2: Alle rollen voor een specifieke site op halen

In dit voorbeeld worden alle rollen van de site P01 .

Get-CMSiteRole -SiteCode P01

Voorbeeld 3: Rollen voor een specifieke server op halen

In dit voorbeeld worden alle rollen geïnstalleerd op het sitesysteem cm01.contoso.local.

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

Voorbeeld 4: Alle beheerpunten tellen

In dit voorbeeld worden alle beheerpunten in de hiërarchie opgetelde en wordt het aantal weergegeven.

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

Voorbeeld 5: Alle rollen op naam noemen

In dit voorbeeld worden de rolnamen voor alle sites in de hiërarchie vermeld.

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

PARAMETERS

-AllSite

Neem deze parameter op om alle rollen voor de site op te halen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: AllSites

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Type: IResultObject
Parameter Sets: SearchByValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-RoleName

Geef een specifieke rolnaam op om op te halen. De waarde is de tekenreeks van de eigenschap RoleName van de SMS_SCI_SysResUse klasse. Bijvoorbeeld:

  • 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

Notitie

Deze lijst bevat mogelijk niet alle mogelijke siterollen.

Type: String
Parameter Sets: SearchByName
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-SiteCode

Geef de sitecode op voor de specifieke siterol.

Type: String
Parameter Sets: SearchByName
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SiteSystemServerName

Geef de naam op van een specifieke sitesysteemserver van waaruit u de rol wilt krijgen.

Type: String
Parameter Sets: SearchByName
Aliases: Name, ServerName

Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_SCI_SysResUse

IResultObject#SMS_SCI_SysResUse

OPMERKINGEN

Remove-CMSiteRole

Get-CMSiteFeature

Get-CMSiteSystemServer