Add-CMObjectSecurityScope
將安全性範圍新增至物件。
語法
Add-CMObjectSecurityScope
-InputObject <IResultObject[]>
[-Scope] <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMObjectSecurityScope
-Id <String>
-InputObject <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMObjectSecurityScope
-InputObject <IResultObject[]>
[-Name] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 將安全性範圍新增至 Configuration Manager 物件。
如需安全性範圍的詳細資訊,請參閱 Configuration Manager 中以角色為基礎的系統管理基本概念。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:將安全性範圍新增至應用程式物件
第一個命令會建立名為 Scope1 的安全性範圍物件,並將它儲存在 $Scope 變數中。
第二個命令會取得名稱開頭為 「Central」 的所有應用程式物件。 然後,它會使用管線運算符將對象傳遞至 Add-CMObjectSecurityScope。 此 Cmdlet 會將安全性範圍新增至每個應用程式物件。
$Scope = New-CMSecurityScope -Name "Scope1" -Description "Security scope 1"
Get-CMApplication -Name "Central*" | Add-CMObjectSecurityScope -Scope $Scope
參數
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Id
指定要新增至 Configuration Manager 物件之安全性範圍的標識碼。 這個值是 CategoryID
屬性,例如SMS00UNA
預設範圍。
類型: | String |
別名: | SecurityScopeId |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定 Configuration Manager 物件的陣列,以新增安全性範圍。 若要取得這個物件,請使用 物件類型的 Get Cmdlet。 例如, 應用程式物件的 Get-CMApplication 。
類型: | IResultObject[] |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Name
指定要新增至 Configuration Manager 物件的安全性範圍名稱。
類型: | String |
別名: | SecurityScopeName |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Scope
指定要加入的安全性範圍物件陣列。 若要取得此物件,請使用 Get-CMSecurityScope Cmdlet。
類型: | IResultObject[] |
別名: | SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
輸出
System.Object