Add-CMObjectSecurityScope

Fügen Sie einem Objekt einen Sicherheitsbereich hinzu.

Syntax

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um einem Configuration Manager-Objekt einen Sicherheitsbereich hinzuzufügen.

Weitere Informationen zu Sicherheitsbereichen finden Sie unter Grundlagen der rollenbasierten Verwaltung in Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Hinzufügen eines Sicherheitsbereichs zu Anwendungsobjekten

Der erste Befehl erstellt ein Sicherheitsbereichsobjekt mit dem Namen Scope1 und speichert es in der variablen $Scope .

Der zweite Befehl ruft alle Anwendungsobjekte ab, deren Name mit "Central" beginnt. Anschließend wird der Pipelineoperator verwendet, um die Objekte an Add-CMObjectSecurityScope zu übergeben. Dieses Cmdlet fügt jedem Anwendungsobjekt den Sicherheitsbereich hinzu.

$Scope = New-CMSecurityScope -Name "Scope1" -Description "Security scope 1"
Get-CMApplication -Name "Central*" | Add-CMObjectSecurityScope -Scope $Scope

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-Id

Geben Sie die ID eines Sicherheitsbereichs an, der einem Configuration Manager -Objekt hinzugefügt werden soll. Dieser Wert ist die CategoryID -Eigenschaft, z. B SMS00UNA . für den Standardbereich .

Type:String
Aliases:SecurityScopeId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Geben Sie ein Array von Configuration Manager -Objekten an, um den Sicherheitsbereich hinzuzufügen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get für den Objekttyp. Beispiel: Get-CMApplication für App-Objekte .

Type:IResultObject[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Geben Sie den Namen eines Sicherheitsbereichs an, der einem Configuration Manager -Objekt hinzugefügt werden soll.

Type:String
Aliases:SecurityScopeName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Geben Sie ein Array von hinzuzufügenden Sicherheitsbereichsobjekten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSecurityScope .

Type:IResultObject[]
Aliases:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Ausgaben

System.Object