Dela via


Set-CMSecurityRole

SYNOPSIS

Ändrar konfigurationsinställningarna för en säkerhetsroll.

SYNTAX

SetByValue (standard)

Set-CMSecurityRole [-Description <String>] -InputObject <IResultObject> [-NewName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetById

Set-CMSecurityRole [-Description <String>] -Id <String> [-NewName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMSecurityRole [-Description <String>] -Name <String> [-NewName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Set-CMSecurityRole ändrar konfigurationsinställningarna för en säkerhetsroll. Du kan använda den här cmdleten för att ändra namn och beskrivning av en säkerhetsroll.

Anteckning

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

EXAMPLES

Exempel 1: Ändra namnet på en säkerhetsroll med hjälp av ett ID

PS XYZ:\> Set-CMSecurityRole -Id "CM100003" -NewName "RTOperator02"

Det här kommandot byter namn på den säkerhetsroll som har ID:t CM100003. Kommandot ändrar namnet till RTOperator02.

Exempel 2: Ändra namnet på en säkerhetsroll med hjälp av ett namn

PS XYZ:\> Set-CMSecurityRole -Name "SRole02" -NewName "RTOperator02"

Det här kommandot byter namn på säkerhetsrollen SRole02. Kommandot ändrar namnet till RTOperator02.

Exempel 3: Ändra namnet på en säkerhetsroll med hjälp av en objektvariabel

PS XYZ:\> $Srole = Get-CMSecurityRole -Id "CM100003"
PS XYZ:\> Set-CMSecurityRole -Inputobject $Srole -NewName "RTOperator02"

Det första kommandot hämtar säkerhetsrollen som har ID:t CM100003 och lagrar den i $Srole variabeln.

Det andra kommandot byter namn på säkerhetsrollen för objektet som lagras i $Srole. Kommandot ändrar namnet till RTOperator02.

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

-Id

Anger en matris med SÄKERHETSROLLER.

Type: String
Parameter Sets: SetById
Aliases: RoleId

Required: True
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: SetByValue
Aliases:

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

-Name

Anger en matris med namn på säkerhetsroller.

Type: String
Parameter Sets: SetByName
Aliases: RoleName

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

-NewName

Anger ett nytt namn för säkerhetsrollen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
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

Copy-CMSecurityRole

Export-CMSecurityRole

Get-CMSecurityRole

Import-CMSecurityRole

Remove-CMSecurityRole

Remove-CMSecurityRoleFromAdministrativeUser