Udostępnij za pośrednictwem

Get-CMSiteRole

  • Artykuł

SYNOPSIS

Pobierz obiekt roli lokacji.

SYNTAX

SearchByName (wartość domyślna)

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

SearchByValue

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

DESCRIPTION

Zwraca role zainstalowane na Menedżer konfiguracji serwera systemu lokacji. Na przykład punkt zarządzania lub punkt dystrybucji.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Uzyskiwanie wszystkich ról ze wszystkich lokacji

Ten przykład pobiera wszystkie role dla wszystkich lokacji w hierarchii.

Get-CMSiteRole -AllSite

Przykład 2: Uzyskiwanie wszystkich ról dla określonej witryny

W tym przykładzie wszystkie role są pobierane z lokacji P01.

Get-CMSiteRole -SiteCode P01

Przykład 3: Uzyskiwanie ról dla określonego serwera

Ten przykład pobiera wszystkie role zainstalowane w systemie lokacji cm01.contoso.local.

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

Przykład 4: Zlicz wszystkie punkty zarządzania

Ten przykład pobiera wszystkie punkty zarządzania w hierarchii i wyświetla liczbę.

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

Przykład 5. Lista wszystkich ról według nazwy

W tym przykładzie wymieniono nazwy ról dla wszystkich lokacji w hierarchii.

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

PARAMETERS

-AllSite

Dołącz ten parametr, aby pobrać wszystkie role dla lokacji.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z 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 (Nazwa roli)

Określ określoną nazwę roli do uzyskania. Wartość jest ciągiem z właściwości RoleName klasy SMS_SCI_SysResUse . Na przykład:

  • 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

Uwaga

Ta lista może nie zawierać wszystkich możliwych ról lokacji.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-SiteCode (Kod lokacji)

Określ kod lokacji dla określonej roli lokacji.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-SiteSystemServerName (Nazwa serwera systemu lokacji)

Określ nazwę określonego serwera systemu lokacji, z którego chcesz uzyskać rolę.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_SCI_SysResUse

IResultObject#SMS_SCI_SysResUse

UWAGI

Remove-CMSiteRole

Get-CMSiteFeature

Get-CMSiteSystemServer