New-CMAccessAccount
Fügt einem Zugriffskonto Benutzer oder Gruppen hinzu.
Syntax
New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
[-InputObject] <IResultObject>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-ApplicationId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-ApplicationName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-BootImageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-BootImageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-DriverPackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-DriverPackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemImageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemImageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemInstallerId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemInstallerName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-PackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-PackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet "New-CMAccessAccount" fügt Einem Zugriffskonto Benutzer oder Gruppen hinzu.
Ein Zugriffskonto ist eine Liste von Benutzern oder Gruppen, die auf einen eingerichteten Dienst oder eine Anwendung zugreifen können, der sich auf einem Verteilungspunkt befindet. Beispielsweise können Mitglieder im Zugriffskonto für softwareaktualisierungspunktverbindungen auf zwei Dienste zugreifen, um Softwareupdates zu verwalten: Windows Server Update Services (WSUS) und WSUS Synchronization Manager.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Ändern des Zugriffs auf eine Anwendung mithilfe der Anwendungs-ID
PS XYZ:\> $ID = Get-CMAccessAccount -ApplicationID "12994680"
PS XYZ:\> New-CMAccessAccount -ApplicationID $ID -Type WindowsUser Username "CONTOSO\EDaugherty" -Access "FullControl"Der erste Befehl ruft eine Anwendungs-ID ab und speichert sie dann in der variablen $ID.
Der zweite Befehl ruft die Anwendung ab, die von $ID identifiziert wird, und fügt dem Zugriffskonto einen Benutzer hinzu. Die Berechtigungen des neuen Benutzers werden auf FullControl festgelegt.
Parameter
-Access
Gibt die Zugriffsrechte an, die einem Zugriffskonto zugeordnet sind. Gültige Werte sind: "Kein Zugriff", "Lesen", "Ändern" und "Vollzugriff".
| Type: | AccessRight |
| Accepted values: | NoAccess, Read, Change, FullControl |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountType
Gibt einen Kontotyp an. Gültige Werte sind: Gast, Benutzer, WindowsGroup und WindowsUser.
| Type: | AccessAccountType |
| Accepted values: | User, Guest, Administrator, WindowsUser, WindowsGroup |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationId
Gibt die ID einer Anwendung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Gibt den Namen einer Anwendung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageId
Gibt die ID eines Startimages an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageName
Gibt den Namen eines Startimages an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverPackageId
Gibt die ID eines Treiberpakets an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverPackageName
Gibt den Namen eines Treiberpakets an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.
| Type: | IResultObject |
| Aliases: | Application, BootImage, DriverPackage, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OperatingSystemImageId
Gibt die ID eines Betriebssystemimages an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemImageName
Gibt den Namen eines Betriebssystemimages an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemInstallerId
Gibt die ID eines Betriebssysteminstallationsprogramms an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemInstallerName
Gibt den Namen eines Betriebssysteminstallationsprogramms an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
Gibt die ID eines bereitgestellten Softwareskripts oder -programms an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
Gibt den Namen eines bereitgestellten Softwareskripts oder -programms an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareUpdateDeploymentPackageId
Gibt die ID eines bereitgestellten Softwareupdates an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareUpdateDeploymentPackageName
Gibt den Namen eines bereitgestellten Softwareupdates an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
Gibt einen Windows Benutzerkontonamen im Domänen-/Benutzerformat an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject