Dela via


Copy-CMSecurityRole

SYNOPSIS

Skapar en anpassad säkerhetsroll.

SYNTAX

CopyFromId (standard)

Copy-CMSecurityRole [-Description <String>] -Name <String> -SourceRoleId <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

CopyFromName

Copy-CMSecurityRole [-Description <String>] -Name <String> -SourceRoleName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

CopyFromValue

Copy-CMSecurityRole [-Description <String>] -InputObject <IResultObject> -Name <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Copy-CMSecurityRole skapar en ny säkerhetsroll genom att använda en befintlig säkerhetsroll som mall. Konfigurationshanteraren har flera inbyggda säkerhetsroller. Om du kräver fler säkerhetsroller kan du skapa en anpassad säkerhetsroll genom att kopiera en befintlig säkerhetsroll och ändra kopian.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Kopiera en säkerhetsroll med hjälp av ett ID

PS XYZ:\>Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"

Det här kommandot skapar en ny säkerhetsroll med namnet SecRole02 genom att kopiera säkerhetsrollen som har ID SMS000CR.

Exempel 2: Kopiera en säkerhetsroll med hjälp av ett namn

PS XYZ:\>Copy-CMSecurityRole -Name "SecRole02" -SourceRoleName "Software Update Manager"

Det här kommandot skapar en ny säkerhetsroll med namnet SecRole02 genom att kopiera säkerhetsrollen Programuppdateringshanteraren.

Exempel 3: Kopiera en säkerhetsroll

PS XYZ:\> $Srole = Get-CMSecurityRole -Name "Software Update Manager"
PS XYZ:\> Copy-CMSecurityRole -InputObject $Srole -Name "SecRole02"

Det första kommandot hämtar säkerhetsrollen med namnet Programuppdateringshanteraren och lagrar den i $Srole variabeln.

Det andra kommandot skapar en ny säkerhetsroll med namnet SecRole02 genom att kopiera objektet som lagras i $Srole.

PARAMETERS

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-Beskrivning

Anger beskrivningen av en säkerhetsroll.

Type: String
Parameter Sets: (All)
Aliases: RoleDescription

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Anger ett CMSecurityRole-objekt. Om du vill hämta ett CMSecurityRole-objekt använder du cmdleten Get-CMSecurityRole.

Type: IResultObject
Parameter Sets: CopyFromValue
Aliases:

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

-Name

Anger ett namn för den nya säkerhetsomfattningen.

Type: String
Parameter Sets: (All)
Aliases: RoleName

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

-SourceRoleId

Anger ID för en säkerhetsroll.

Type: String
Parameter Sets: CopyFromId
Aliases: CopiedFromId

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

-SourceRoleName

Anger namnet på en säkerhetsroll.

Type: String
Parameter Sets: CopyFromName
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Export-CMSecurityRole

Get-CMSecurityRole

Import-CMSecurityRole

Remove-CMSecurityRole

Remove-CMSecurityRoleFromAdministrativeUser

Set-CMSecurityRole