Dela via

Get-CMSiteRole

  • Artikel

SYNOPSIS

Hämta ett platsrollobjekt.

SYNTAX

SearchByName (standard)

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

SearchByValue

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

DESCRIPTION

Returnerar de roller som är installerade Konfigurationshanteraren en platssystemserver. Till exempel en hanteringsplats eller distributionsplats.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta alla roller från alla platser

Det här exemplet hämtar alla roller för alla platser i hierarkin.

Get-CMSiteRole -AllSite

Exempel 2: Hämta alla roller för en specifik plats

Det här exemplet hämtar alla roller från platsen P01.

Get-CMSiteRole -SiteCode P01

Exempel 3: Hämta roller för en specifik server

I det här exemplet installeras alla roller på platssystemet cm01.contoso.local.

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

Exempel 4: Räkna alla hanteringsplatser

Det här exemplet hämtar alla hanteringsplatser i hierarkin och visar antalet.

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

Exempel 5: Lista alla roller efter namn

I det här exemplet visas rollnamnen för alla platser i hierarkin.

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

PARAMETERS

-AllSite

Inkludera den här parametern för att hämta alla roller för platsen.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med 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

Ange ett specifikt rollnamn att hämta. Värdet är strängen från egenskapen RoleName i SMS_SCI_SysResUse klassen. Ett exempel:

  • 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

Anteckning

Listan kanske inte innehåller alla möjliga platsroller.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-SiteCode

Ange platskoden för den specifika platsrollen.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-SiteSystemServerName

Ange namnet på en specifik platssystemserver som du vill hämta rollen från.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_SCI_SysResUse

IResultObject#SMS_SCI_SysResUse

ANTECKNINGAR

Remove-CMSiteRole

Get-CMSiteFeature

Get-CMSiteSystemServer