Get-CMSiteRole

  • リファレンス
モジュール:
ConfigurationManager

サイトの役割オブジェクトを取得します。

構文

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

説明

Configuration Manager サイト システム サーバーにインストールされている役割を返します。 たとえば、管理ポイントや配布ポイントなどです。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: すべてのサイトからすべての役割を取得する

この例では、階層内のすべてのサイトのすべての役割を取得します。

Get-CMSiteRole -AllSite

例 2: 特定のサイトのすべての役割を取得する

この例では、サイト P01 からすべての役割を取得します。

Get-CMSiteRole -SiteCode P01

例 3: 特定のサーバーの役割を取得する

この例では、サイト システム cm01.contoso.local にインストールされているすべての役割を取得します。

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

例 4: すべての管理ポイントを数える

この例では、階層内のすべての管理ポイントを取得し、カウントを表示します。

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

例 5: すべての役割を名前で一覧表示する

この例では、階層内のすべてのサイトの役割名を一覧表示します。

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

パラメーター

-AllSite

サイトのすべての役割を取得するには、このパラメーターを含める必要があります。

Type:SwitchParameter
Aliases:AllSites
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject
Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-RoleName

取得する特定の役割名を指定します。 値は、クラスのRoleNameプロパティのSMS_SCI_SysResUseです。 例:

  • 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

注意

このリストには、考えられるすべてのサイトロールが含まれるとは限りない場合があります。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-SiteCode

特定のサイト ロールのサイト コードを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteSystemServerName

役割を取得する特定のサイト システム サーバーの名前を指定します。

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject