app controller in system center 2012

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, -OutBuffer, and -OutVariable.. Default Value none This cmdlet supports the common parameters: V

Trang 2

Cmdlet Reference for App Controller

in System Center 2012 SP1

Microsoft

Summary: The Windows PowerShell module for App Controller includes cmdlets that

are designed specifically for App Controller This Cmdlet Reference contains the help files for these cmdlets The topics in this guide include information about the cmdlets and their associated parameters, and provide examples about how to use the cmdlets

Category: Reference

Applies to: System Center 2012 Service Pack 1 (SP1) - App Controller

Source: TechNet Library ( http://technet.microsoft.com/en-us/library/hh781180.aspx )

E-book publication date: April 2013

Trang 3

Microsoft and the trademarks listed at

http://www.microsoft.com/about/legal/en/us/IntellectualProperty/Trademarks/EN-US.aspx are trademarks of the Microsoft group of companies All other marks are property of their respective owners

The example companies, organizations, products, domain names, email addresses, logos, people, places, and events depicted herein are fictitious No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred

This book expresses the author’s views and opinions The information contained in this book is provided without any express, statutory, or implied warranties Neither the authors, Microsoft Corporation, nor its resellers, or distributors will be held liable for any damages caused or alleged to be caused either directly or indirectly by this book

Trang 4

Contents

Add-SCACAzureDisk 5

Add-SCACAzureImage 9

Add-SCACAzureSubscription 13

Add-SCACCloudSystem 16

Add-SCACShare 20

Add-SCACUserRole 22

Add-SCACUserRoleMember 24

Add-SCACUserRoleScope 26

Export-SCACAesKey 29

Get-SCACAdminSetting 31

Get-SCACAzureHostedService 34

Get-SCACAzureRoleInstance 36

Get-SCACAzureServiceDeployment 37

Get-SCACCloud 40

Get-SCACCloudSystem 42

Get-SCACJob 44

Get-SCACServer 45

Get-SCACServiceDeployment 48

Get-SCACTemporaryStorage 50

Get-SCACUserRole 51

Remove-SCACAzureSubscription 53

Remove-SCACCloudSystem 55

Remove-SCACShare 57

Remove-SCACUserRole 59

Remove-SCACUserRoleMember 61

Trang 5

Remove-SCACUserRoleScope 63

Resume-SCACServiceDeployment 65

Set-SCACAdminSetting 67

Set-SCACCloudSystem 70

Set-SCACTemporaryStorage 72

Suspend-SCACServiceDeployment 74

Trang 6

Add-SCACAzureDisk

Adds a virtual hard disk to Windows Azure

Syntax

Parameter Set: SourcePath

AddSCACAzureDisk Cloud <ACAzureSubscriptionCloud> DisplayName <String> Name <String> OperatingSystem {None | Windows | Linux} -SourcePath <String> -StorageBlob <Uri> [-Force] [

-<CommonParameters>]

Parameter Set: SourceVHD

AddSCACAzureDisk Cloud <ACAzureSubscriptionCloud> DisplayName <String> Name <String> OperatingSystem {None | Windows | Linux} -SourceVHD <StandaloneVirtualHardDisk> -StorageBlob

-<Uri> [-Force] [ <CommonParameters>]

Detailed Description

The Add-SCACAzureDisk cmdlet adds a virtual hard disk to Windows Azure

You must import the Virtual Machine Manager (VMM) module into your session to run this cmdlet

Accept Wildcard Characters? false

Trang 7

Position? named

Trang 8

Default Value none

Trang 9

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable,

-OutBuffer, and -OutVariable For more information, see about_CommonParameters

The first command gets all cloud objects and stores the objects in the $Clouds variable

The second command adds the virtual hard disk named VHD01.vhd to the specified container in the first cloud stored in $Clouds

PS C:\> $Clouds = Get-SCACCloud

PS C:\> AddSCACAzureDisk Name "VHD01" DisplayName "VHD01.vhd" Cloud $Clouds[0]

-StorageBlob "https://container01.blob.core.windows.net/vhds/VHD01.vhd" -SourcePath

“\\FileShare\VMs\Vhd01.vhd" -OperatingSystem "Windows" -Force

Related topics

Add-SCACAzureImage

Trang 10

Add-SCACAzureImage

Adds a virtual hard drive to the Windows Azure image store

Syntax

Parameter Set: SourcePath

AddSCACAzureImage Cloud <ACAzureSubscriptionCloud> DisplayName <String> Name <String> OperatingSystem {None | Windows | Linux} -SourcePath <String> -StorageBlob <Uri> [-Force] [

-<CommonParameters>]

Parameter Set: SourceVHD

AddSCACAzureImage Cloud <ACAzureSubscriptionCloud> DisplayName <String> Name <String> OperatingSystem {None | Windows | Linux} -SourceVHD <StandaloneVirtualHardDisk> -StorageBlob

-<Uri> [-Force] [ <CommonParameters>]

The Add-SCACAzureImage cmdlet adds a virtual hard drive to the Windows Azure image store

You must import the Virtual Machine Manager (VMM) module into your session to run this cmdlet

Trang 11

Position? named

Trang 12

Default Value none

Trang 13

Examples

- EXAMPLE 1 -

Description

-

The first command gets all cloud objects and adds the objects to the $Clouds parameter

The second command gets the virtual hard disk object named VHD01.vhd and stores the object in the

$VHD variable

The last command adds the VHD image and names it Image01

PS C:\> $Clouds = Get-SCACCloud

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"

PS C:\> AddSCACAzureImage –Name "Image01" DisplayName "Image01" Cloud $Clouds[0]

StorageBlob "http://container01.blob.core.windows.net/vhds/VHD01.vhd" SourceVHD $VHD

Trang 14

Add-SCACAzureSubscription

Adds a Windows Azure subscription to App Controller

Syntax

Parameter Set: Default

Add-SCACAzureSubscription [-Name] <String> [-Id] <Guid> [-ManagementCertificatePath] <String> [-ManagementCertificatePassword] <SecureString> [-Description <String> ] [ <CommonParameters>]

Trang 15

Inputs

The input type is the type of the objects that you can pipe to the cmdlet

 System.String, System.Guid, System.String, System.Security.SecureString,

Microsoft.SystemCenter.CloudManager.PowerShell.ACServer

Trang 16

1626950e-3af6-4fe8-a7d2-PS C:\> $MCPassword = ConvertTo-SecureString "PassWord!" -AsPlainText -Force

PS C:\> Add-SCACAzureSubscription –Id "1626950e-3af6-4fe8-a7d2-e489c18931a2" –

ManagementCertificatePassword $MCPassword –ManagementCertificatePath "C:\CertificatePath" – Name "AzureSubscription01"

Related topics

Remove-SCACAzureSubscription

Trang 17

Add-SCACCloudSystem [-Name] <String> [-ServerName] <String> [-Port] <Int32> -VMM [-Description

Trang 18

Accept Pipeline Input? false

Trang 19

Required? true

Trang 20

The second command adds a service provider connection

PS C:\> $Password = ConvertTo-SecureString "PassWord!" -AsPlainText -Force

PS C:\> Add-SCACCloudsystem -Name "ServiceProvider01" -ServiceLocation

49ca-aa7a-efd6e4b372a3" -CertificateFilePath "\\FileServer01\Certs\TenantCert.pfx" -

Trang 21

Add-SCACShare

Adds a library share

Syntax

Add-SCACShare [-Path] <String> [ <CommonParameters>]

Examples

- EXAMPLE 1 -

Description

-

This command adds the share named \\LibraryServer\LibraryPath

PS C:\> Add-SCACShare -Path "\\LibraryServer\LibraryPath"

Trang 22

Related topics

Remove-SCACShare

Trang 23

Add-SCACUserRole

Creates an App Controller user role

Syntax

Add-SCACUserRole [-Name] <String> [-Description <String> ] [-IsReadOnly] [ <CommonParameters>]

-Name<String>

Specifies a name for the user role

Trang 24

Examples

- EXAMPLE 1 -

Description

-

This example creates a read-only user role named UserRole01

PS C:\>Add-SCACUserRole -Name "UserRole01" -Description "Test User Role" -IsReadOnly

Trang 25

Add-SCACUserRoleMember

Adds a member to a user role

Syntax

Add-SCACUserRoleMember [-UserRole] <ACUserRole> [-Member] <String> [ <CommonParameters>]

Trang 26

PS C:\> $UserRole = Get-SCACUserRole –Managed | where { $_.Name –eq "UserRole01" }

PS C:\> Add-SCACUserRoleMember –UserRole $UserRole –Member "Contoso\ReneeLo"

Related topics

Remove-SCACUserRoleMember

Trang 27

Parameter Set: AzureScope

Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-AzureSubscriptionScope]

<ACAzureSubscriptionCloud> [ <CommonParameters>]

Parameter Set: SPFScope

Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-ServiceProviderConnectionScope]

<ACCloudSystem> [-VmmUserRoleName] <String> [ <CommonParameters>]

The Add-SCACUserRoleScope function adds Service Provider Foundation connection cloud objects to the scope of objects that a user role can manage This cmdlet only works with Virtual Machine Manager (VMM) clouds

Trang 28

Aliases none

Trang 29

The second command gets the cloud system object named SvcProvider01.Contoso.com and stores the object in the $CloudSystem variable

The last command adds the cloud system stored in $CloudSystem to the scope of UserRole01

PS C:\> $UserRole = Get-SCACUserRole -Managed | where {$_.Name -eq "UserRole01"}

PS C:\> $CloudSystem = Get-SCACCloudSystem -Name "SvcProvider01.Contoso.com"

PS C:\> Add-SCACUserRoleScope -UserRole $UserRole -ServiceProviderConnectionScope

$CloudSystem -VMMUserRoleName "TenantSSUserRole01"

Related topics

Remove-SCACUserRoleScope

Trang 30

Export-SCACAesKey

Exports the App Controller AES key from the registry to the specified file

Syntax

Export-SCACAesKey [-Path] <String> [-Password] <SecureString> [ <CommonParameters>]

Trang 31

PS C:\>$Password = ConvertTo-SecureString "PassWord!" -AsPlainText -Force

PS C:\> Export-SCACAESKey -Path "C:\Keys\Key.txt" -Password $Password

Trang 32

Get-SCACAdminSetting

Gets one or more administrator settings from the App Controller server

Syntax

Parameter Set: CEIP

Get-SCACAdminSetting [[-CEIPEnabled]] [ <CommonParameters>]

Parameter Set: JobHistoryPeriod

Get-SCACAdminSetting [[-JobHistoryPeriodInDays]] [ <CommonParameters>]

Parameter Set: RefreshInterval

Get-SCACAdminSetting [[-RefreshIntervalInSeconds]] [ <CommonParameters>]

Trang 33

Default Value none

Trang 34

Related topics

Set-SCACAdminSetting

Trang 35

Get-SCACAzureHostedService

Gets the hosted services on a specified Windows Azure cloud

Syntax

Get-SCACAzureHostedService [-Cloud] <ACAzureSubscriptionCloud> [ <CommonParameters>]

Accept Pipeline Input? True (ByValue)

Trang 36

PS C:\> $CloudSystem = Get-SCACCloudSystem -Name "CloudSystem01.Contoso.com"

PS C:\> $Cloud = Get-SCACCloud -CloudSystem $CloudSystem

PS C:\> Get-SCACAzureHostedService -Cloud $Cloud

Trang 37

The Get-SCACAzureRoleInstance cmdlet gets all role instances running in Windows Azure This cmdlet

is for internal use only and is not meant to be used directly by Administrators

Parameters

Examples

PS C:\> # The Get-SCACAzureRoleInstance cmdlet is for internal use only

Trang 38

Get-SCACAzureServiceDeployment

Gets a specified Windows Azure service deployment

Syntax

Parameter Set: Cloud

Get-SCACAzureServiceDeployment [-Cloud] <ACCloud> [ <CommonParameters>]

Parameter Set: HostedService

Get-SCACAzureServiceDeployment [-HostedService] <ACAzureHostedService> [[-DeploymentSlot]

Accept Pipeline Input? True (ByValue)

Trang 39

The last command gets the Windows Azure service deployment for the first hosted service stored in the

$HostedService array and displays information about the service deployment to the user

PS C:\> $CloudSystem = Get-SCACCloudSystem -Name "CloudSystem01.Contoso.com"

PS C:\> $Cloud = Get-SCACCloud -CloudSystem $CloudSystem

PS C:\> $HostedService = @(Get-SCACAzureHostedService -Cloud $Cloud)

PS C:\> Get-SCACAzureServiceDeployment -HostedService $HostedService[0]

Định dạng
Số trang	76
Dung lượng	1,32 MB