Get-CMObjectSecurityScope

オブジェクトのセキュリティ スコープを取得します。

構文

Get-CMObjectSecurityScope
   -InputObject <IResultObject>
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMObjectSecurityScope
   [-Id <String>]
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

Configuration Manager オブジェクトに関連付けられているセキュリティ スコープを取得するには、このコマンドレットを使用します。

セキュリティ スコープの詳細については、「 Configuration Manager でのロールベースの管理の基礎」を参照してください。

注:

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

例 1: アプリケーションのセキュリティ スコープを取得する

このコマンドは、最初に Central app という名前のアプリケーション オブジェクトを取得します。 次に、パイプライン演算子を使用して Get-CMObjectSecurityScope にオブジェクトを渡します。これは、アプリケーション オブジェクトに関連付けられているすべてのセキュリティ スコープを取得します。

Get-CMApplication -Name "Central app" | Get-CMObjectSecurityScope

例 2: パッケージのセキュリティ スコープを取得する

このコマンドは、ID XYZ00001を持つパッケージに関連付けられている Scope1 という名前のセキュリティ スコープを取得します。

$pkg = Get-CMPackage -Id "XYZ00001"
Get-CMObjectSecurityScope -InputObject $pkg -Name "Scope1"

パラメーター

-DisableWildcardHandling

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

Configuration Manager オブジェクトに関連付けられているセキュリティ スコープの ID を指定します。 この値は、既定のスコープのSMS00UNAなど、CategoryID プロパティです。

型:String
Aliases:CategoryId
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

セキュリティ スコープに関連付けられている Configuration Manager オブジェクトを指定します。 このオブジェクトを取得するには、オブジェクト型の Get コマンドレットを使用します。 たとえば、アプリ オブジェクト の Get-CMApplication などです。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

Configuration Manager オブジェクトに関連付けられているセキュリティ スコープの名前を指定します。

型:String
Aliases:CategoryName
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_SecuredCategory」を参照してください。